> 技术文档 > 【Git#5】远程操作 & 标签管理

【Git#5】远程操作 & 标签管理

在这里插入图片描述

📃个人主页:island1314

⛺️ 欢迎关注:👍点赞 👂🏽留言 😍收藏 💞 💞 💞

  • 生活总是不会一帆风顺,前进的道路也不会永远一马平川,如何面对挫折影响人生走向 – 《人民日报》

🔥 目录

    • 一、理解分布式版本操作系统
    • 二、远程操作
      • 1. 概述
      • 2. 新建远程仓库
      • 3. 克隆远程仓库
      • 4. 向远程仓库推送
      • 5. 拉取远程仓库
    • 三、git 配置
      • 1. 忽略特殊文件
      • 2. 给命令配置别名
    • 四、标签管理
      • 1. 理解标签
      • 2. 创建标签
      • 3. 操作标签

一、理解分布式版本操作系统

我们目前所说的所有内容(工作区,暂存区,版本库等等),都是在本地!也就是在你的笔记本或者计算机上。而我们的 Git 其实是分布式版本控制系统!什么意思呢?

可以简单理解为,我们每个人的电脑上都是一个完整的版本库,这样你工作的时候,就不需要联网了,因为版本库就在你自己的电脑上。既然每个人电脑上都有一个完整的版本库,那多个人如何协作呢?

  • 比方说你在自己电脑上改了文件A,你的同事也在他的电脑上改了文件A,这时,你们俩之间只需把各自的修改推送给对方,就可以互相看到对方的修改了。

【Git#5】远程操作 & 标签管理

分布式版本控制系统的安全性要高很多,因为每个人电脑里都有完整的版本库,某一个人的电脑坏掉了不要紧,随便从其他人那里复制一个就可以了。

在实际使用分布式版本控制系统的时候,其实很少在两人之间的电脑上推送版本库的修改,因为可能你们俩不在一个局域网内,两台电脑互相访问不了。也可能今天你的同事病了,他的电脑压根没有开机。

  • 因此:分布式版本控制系统通常也有一台充当“中央服务器”的电脑,但这个服务器的作用仅仅是用来方便“交换”大家的修改,没有它大家也一样干活,只是交换修改不方便而已。

有了这个“中央服务器”的电脑,这样就不怕本地出现什么故障了(比如运气差,硬盘坏了,上面的所有东西全部丢失,包括 git 的所有内容)

二、远程操作

1. 概述

🔥 Git 是分布式版本控制系统,同一个Git 仓库,可以分布到不同的机器上。怎么分布呢?最早,肯定只有一台机器有一个原始版本库,此后,别的机器可以“克隆”这个原始版本库,而且每台机器的版本库其实都是一样的,并没有主次之分。

你肯定会想,至少需要两台机器才能玩远程库不是?但是我只有一台电脑,怎么玩?

  • 其实一台电脑上也是可以克隆多个版本库的,只要不在同一个目录下。不过,现实生活中是不会有人这么傻的在一台电脑上搞几个远程库玩,因为一台电脑上搞几个远程库完全没有意义,而且硬盘挂了会导致所有库都挂掉,所以我也不告诉你在一台电脑上怎么克隆多个仓库。

实际情况往往是这样,找一台电脑充当服务器的角色,每天24小时开机,其他每个人都从这个“服务器”仓库克隆一份到自己的电脑上,并且各自把各自的提交推送到服务器仓库里,也从服务器仓库中拉取别人的提交。

完全可以自己搭建一台运行 Git 的服务器,不过现阶段,为了学 Git 先搭个服务器绝对是小题大作。

  • 好在这个世界上有个叫 GitHub 的神奇的网站,从名字就可以看出,这个网站就是提供 Git 仓库托管服务的,所以,只要注册一个 GitHub 账号,就可以免费获得 Git 远程仓库。

github 是国外的网站,速度比较慢,我们课堂上同统一采用码云来托管代码。下面我们从零开始,使用一下码云远程仓库 Gitee

2. 新建远程仓库

① 新建项目远程仓库

【Git#5】远程操作 & 标签管理

② 填写基本信息并且创建

【Git#5】远程操作 & 标签管理

③ 创建成功后,可以对远程仓库进行一个基本的设置:开源 or 私有

【Git#5】远程操作 & 标签管理

④ 从创建好的远程仓库中我们便能看到,之前在本地学习过的分支,也存在于远程仓库中并被管理起来了。刚创建的仓库有且只有一个默认的 master 分支。

【Git#5】远程操作 & 标签管理

3. 克隆远程仓库

克隆/下载远端仓库到本地,需要使用 git clone 命令,后面跟上我们的远端仓库的链接,远端仓库的链接可以从仓库中找到:选择“克隆/下载” 获取远程仓库链接:

【Git#5】远程操作 & 标签管理

SSH 协议和 HTTPS 协议是 Git 最常使用的两种数据传输协议。

  • SSH 协议使用了公钥加密和公钥登陆机制,体现了其实用性和安全性,使用此协议需要将我们的公钥放上服务器,由Git服务器进行管理

  • 使用 HTTPS 方式时,没有要求,可以直接克隆下来。

使用 HTTPS 方式

lighthouse@VM-8-10-ubuntu:gitcode$ git clone https://gitee.com/island0920/git_learning.gitCloning into \'git_learning\'...remote: Enumerating objects: 4, done.remote: Counting objects: 100% (4/4), done.remote: Compressing objects: 100% (4/4), done.remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)Receiving objects: 100% (4/4), done.lighthouse@VM-8-10-ubuntu:gitcode$ lsbook git_learning

使用 SSH 方式

lighthouse@VM-8-10-ubuntu:gitcode$ git clone git@gitee.com:island0920/git_learning.gitCloning into \'git_learning\'...The authenticity of host \'gitee.com (180.76.198.225)\' can\'t be established.ED25519 key fingerprint is SHA256:+ULzij2u99B9eWYFTw1Q4ErYG/aepHLbu96PAUCoV88.This key is not known by any other namesAre you sure you want to continue connecting (yes/no/[fingerprint])? yesWarning: Permanently added \'gitee.com\' (ED25519) to the list of known hosts.git@gitee.com: Permission denied (publickey). # 公钥fatal: Could not read from remote repository.Please make sure you have the correct access rightsand the repository exists.

使用 SSH方式克隆仓库,由于我们没有添加公钥到远端库中,服务器拒绝了我们的 clone 链接。需要我们设置一下:

第一步:创建SSH Key

  • 在用户主目录下,看看有没有.ssh目录,如果有,再看看这个目录下有没有id rsa 和 id rsa.pub 这两个文件,如果已经有了,可直接跳到下一步。
  • 如果没有,需要创建 SSH Key,如下:
lighthouse@VM-8-10-ubuntu:gitcode$ ssh-keygen -t rsa -C \"island0920@163.com\"Generating public/private rsa key pair.Enter file in which to save the key (/home/lighthouse/.ssh/id_rsa): Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/lighthouse/.ssh/id_rsaYour public key has been saved in /home/lighthouse/.ssh/id_rsa.pubThe key fingerprint is:SHA256:fslO9I2D3invlg7yVrTaVc island0920@163.comThe key\'s randomart image is:+---[RSA 3072]----+| E || o . o . || + + o . = . || . o + + o.+ || . S =. .o || . . O.=o+ || . +.Xo+.. || ..X+ooo || ooo=** |+----[SHA256]-----+

顺利的话,可以在用户主目录里找到.ssh 目录,里面有 id_rsaid_rsa.pub 两个文件,这两个就是SSH Key的秘钥对,id_rsa 是私钥,不能泄露出去,id_rsa.pub 是公钥,可以放心地告诉任何人

lighthouse@VM-8-10-ubuntu:~$ ls -a .ssh/. .. id_rsa id_rsa.pub known_hostslighthouse@VM-8-10-ubuntu:~$ cat .ssh/id_rsa.pub

第二步:添加自己的公钥到远端仓库

【Git#5】远程操作 & 标签管理

点击 SSH公钥,进行设置:

【Git#5】远程操作 & 标签管理

点击确认后,需要对你进行认证,输入你的账号密码即可。至此,我们的准备工作全部做完,欢快的clone吧。

lighthouse@VM-8-10-ubuntu:gitcode$ git clone git@gitee.com:island0920/git_learning.gitCloning into \'git_learning\'...remote: Enumerating objects: 4, done.remote: Counting objects: 100% (4/4), done.remote: Compressing objects: 100% (4/4), done.remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)Receiving objects: 100% (4/4), done.lighthouse@VM-8-10-ubuntu:gitcode$ lsbook git_learninglighthouse@VM-8-10-ubuntu:gitcode$ ls git_learning/README.en.md README.md

🏮 如果有多个人协作开发,GitHub/Gitee 允许添加多个公钥,只要把每个人的电脑上的Key 都添加到 GitHub/Gitee,就可以在每台电脑上往 GitHub/Gitee 上提交推送了。

🐇 当我们从远程仓库克隆后,实际上 Git 会自动把本地的 master 分支和远程的 master分支对应起来并且,远程仓库的默认名称是 origin

在本地我们可以使用 git remote 命令,来查看远程库的信息,如:

lighthouse@VM-8-10-ubuntu:git_learning$ git remoteoriginlighthouse@VM-8-10-ubuntu:git_learning$ clear# 也可以用 git remote -v 显示更详细信息lighthouse@VM-8-10-ubuntu:git_learning$ git remote -vorigingit@gitee.com:island0920/git_learning.git (fetch)origingit@gitee.com:island0920/git_learning.git (push)

🍶 上面显示了可以抓取和推送的origin的地址。如果没有推送权限,就看不到push的地址。推送是什么意思呢,我们继续往下看

4. 向远程仓库推送

📟 本地已经 clone 成功远程仓库后,我们便可以向仓库中提交内容,例如新增一个 file.txt 文件:

lighthouse@VM-8-10-ubuntu:git_learning$ cat file.txthello git# 提交文件lighthouse@VM-8-10-ubuntu:git_learning$ git add .lighthouse@VM-8-10-ubuntu:git_learning$ git commit -m \"create file.txt\"[master acd13ab] create file.txt 1 file changed, 1 insertion(+) create mode 100644 file.txt

提交时要注意,如果我们之前设置过全局的 name 和 e-mail,这两项配置需要和 gitee 上配置的用户名和邮箱一致,否则会出错。或者从来没有设置过全局的 name和 e-mail,那么我们第一次提交时也会报错。这就需要我们重新配置下了,同样要注意需要和 gitee 上配置的用户名和邮箱一致(如何配置之前已讲过)

到这里我们已经将内容提交至本地仓库中,如何将本地仓库的内容推送至远程仓库呢,需要使用 git push 命令

该命令用于将本地的分支版本上传到远程并合并,命令格式如下:

git push<远程主机名><本地分支名>:<远程分支名>#如果本地分支名与远程分支名相同,则可以省略冒号:git push<远程主机名><本地分支名>4

此时我们要将本地的 master 分支推送到 origin 主机的 master 分支,则可以:

lighthouse@VM-8-10-ubuntu:git_learning$ git push origin masterEnumerating objects: 4, done.Counting objects: 100% (4/4), done.Delta compression using up to 2 threadsCompressing objects: 100% (2/2), done.Writing objects: 100% (3/3), 308 bytes | 308.00 KiB/s, done.Total 3 (delta 0), reused 0 (delta 0), pack-reused 0remote: Powered by GITEE.COM [1.1.5]remote: Set trace flag 8d4a07b8To gitee.com:island0920/git_learning.git 7ce19f5..acd13ab master -> master

现在就被推送到远端了

注意:这里由于我们使用的是 SSH 协议,是不用每一次推送都输入密码的,方便了我们的推送操作。如果你使用的是 HTTPS 协议,有个麻烦地方就是每次推送都必须输入口令。

5. 拉取远程仓库

在 gitee 上点击 file.txt 文件并在线修改

  • 此时,远程仓库是要领先于本地仓库一个版本,为了使本地仓库保持最新的版本,我们需要拉取下远端代码,并合并到本地。Git提供了 git pull 命令,该命令用于从远程获取代码并合并本地的版本。

操作如下:

git pull <远程主机名> <远程分⽀名>:<本地分⽀名> # 如果远程分⽀是与当前分⽀合并,则冒号后⾯的部分可以省略。git pull <远程主机名> <远程分⽀名> # 使用样例如下:lighthouse@VM-8-10-ubuntu:git_learning$ git pull origin masterremote: Enumerating objects: 5, done.remote: Counting objects: 100% (5/5), done.remote: Compressing objects: 100% (2/2), done.remote: Total 3 (delta 1), reused 0 (delta 0), pack-reused 0 (from 0)Unpacking objects: 100% (3/3), 963 bytes | 963.00 KiB/s, done.From gitee.com:island0920/git_learning * branch master -> FETCH_HEAD acd13ab..314e885 master -> origin/masterUpdating acd13ab..314e885Fast-forward file.txt | 1 + 1 file changed, 1 insertion(+)

但是大多都遇到过这样的情况,提交代码时出现冲突,提示需要更新,然而不经意的这一操作,将自己书写代码的付出付之东流,全被服务器上的文件覆盖了,那我们能否恢复呢,如下:

  1. 进入需要恢复文件的仓库中,右键打开git bash命令行(git bash或者git cmd都可以),执行以下命令

    git reflog ./ # 该命令显示本地提交的记录,故恢复本地需执行该命令git log ./ # 该命令显示提交到远程服务器的记录
  2. 恢复文件,执行命令

    git reset --hard e33c58d # 最后的数字是需要恢复的commit_id

三、git 配置

1. 忽略特殊文件

在日常开发中,我们有些文件不想或者不应该提交到远端,比如保存了数据库密码的配置文件,那怎么让 Git 知道呢?在 Git 工作区的根目录下创建一个特殊的 .gitignore 文件,然后把要忽略的文件名填进去,Git 就会自动忽略这些文件了。

不需要从头写 .gitignore 文件,gitee 在创建仓库时就可以为我们生成,不过需要我们主动勾选一下:

【Git#5】远程操作 & 标签管理

如果当时没有选择这个选择,在工作区创建一个也是可以的。无论哪种方式,最终都可以得到一个完整的 .gitignore 文件,例如我们想忽略以 .so.ini 结尾所有文件,.gitignore 的内容如下

lighthouse@VM-8-10-ubuntu:git_learning$ cat .gitignore# 可以直接写文件名 - 省略选择的模板内容*.ini*.so# 还需要提交远端lighthouse@VM-8-10-ubuntu:git_learning$ git add .lighthouse@VM-8-10-ubuntu:git_learning$ git commit -m \"add .gitignore\"[master 15730c3] add .gitignore 1 file changed, 4 insertions(+) create mode 100644 .gitignorelighthouse@VM-8-10-ubuntu:git_learning$ git push origin masterEnumerating objects: 4, done.Counting objects: 100% (4/4), done.Delta compression using up to 2 threadsCompressing objects: 100% (3/3), done.Writing objects: 100% (3/3), 405 bytes | 405.00 KiB/s, done.Total 3 (delta 0), reused 0 (delta 0), pack-reused 0remote: Powered by GITEE.COM [1.1.5]remote: Set trace flag 7f4c87a3To gitee.com:island0920/git_learning.git 314e885..15730c3 master -> master

接下来来验证 .gitignore 的功能,如下新增 a.sob.ini

lighthouse@VM-8-10-ubuntu:git_learning$ touch a.so b.inilighthouse@VM-8-10-ubuntu:git_learning$ git statusOn branch masterYour branch is up to date with \'origin/master\'.nothing to commit, working tree clean

检验 .gitignore 的标准就是 git status 命令是不是说 working tree clean 。我们发现Git 并没有提示在工作区中有文件新增,果然 .gitignore 生效了!

但有些时候,你就是想添加一个文件到 Git,但由于这个文件被 .gitignore 忽略了,根本添加不了,那么可以用 -f 强制添加:

$ git add -f [filename]

或者你发现,可能是 .gitignore 写得有问题,需要找出来到底哪个规则写错了,比如说 a.so 文件是要被添加的,可以用 git check-ignore 命令检查:

lighthouse@VM-8-10-ubuntu:git_learning$ git check-ignore -v a.so.gitignore:4:*.soa.so

Git 会告诉我们,.gitignore 的第3行规则忽略了该文件,于是我们就可以知道应该修订哪个规则
还有些时候,当我们编写了规则排除了部分文件时,例如:

# 排除所有.开头的隐藏⽂件: .*

但是我们发现 .* 这个规则把 .gitignore 也排除了。虽然可以用 git add -f 强制添加进去但有强迫症的童鞋还是希望不要破坏 .gitignore 规则,这个时候,可以添加一条例外规则:

# 排除所有.开头的隐藏⽂件: .*

把指定文件排除在 .gitignore 规则外的写法就是 !+文件名 ,所以,只需把例外文件添加进去即可。

lighthouse@VM-8-10-ubuntu:git_learning$ cat .gitignore# 可以直接写文件名 - 省略选择的模板内容*.ini*.so# 排除所有 . 开头的隐藏文件.*# 由于.gitignore也是. 开头, 需要不排除 .gitignore!.gitignore

2. 给命令配置别名

在我们使用 Git 期间,有些命令敲的时候着实让人头疼(太长了,难敲),幸运的是,git支持对命令进行简化!

举个例子,将 git status 简化为 git st ,对应的命令为:

lighthouse@VM-8-10-ubuntu:git_learning$ git config --global alias.st status

--global 参数是全局参数,也就是这些命令在这台电脑的所有Git仓库下都有用。如果不加,那只针对当前的仓库起作用。

现在敲 git st 看看效果:

lighthouse@VM-8-10-ubuntu:git_learning$ git stOn branch masterYour branch is up to date with \'origin/master\'.nothing to commit, working tree clean

再来配置一个 git last ,让其显示最后一次提交信息(标准是 git log -1 进行查看)

lighthouse@VM-8-10-ubuntu:git_learning$ git log -1commit d80980f12ad7d73148be5691baa76c6272e8096c (HEAD -> master, origin/master, origin/HEAD)Author: island0920 <island0920@163.com>Date: Wed Apr 9 14:45:12 2025 +0800 gitignore 配置# 配置 git lastlighthouse@VM-8-10-ubuntu:git_learning$ git config --global alias.last \'log -1\'lighthouse@VM-8-10-ubuntu:git_learning$ git lastcommit d80980f12ad7d73148be5691baa76c6272e8096c (HEAD -> master, origin/master, origin/HEAD)Author: island0920 <island0920@163.com>Date: Wed Apr 9 14:45:12 2025 +0800 gitignore 配置

四、标签管理

1. 理解标签

🐇 标签 tag ,可以简单的理解为是对某次commit 的一个标识,相当于起了一个别名。例如,在项目发布某个版本的时候,针对最后一次 commit 起一个 v1.0 这样的标签来标识里程碑的意义。

  • 这有什么用呢?相较于难以记住的 commit id,tag 很好的解决这个问题,因为 tag 一定要给一个让人容易记住,且有意义的名字
  • 这样当我们需要回退到某个重要版本时,直接使用标签就能很快定位到

2. 创建标签

① 在Git中打标签非常简单,首先,切换到需要打标签的分支上

lighthouse@VM-8-10-ubuntu:git_learning$ git branch* master

② 创建新标签并且查看

# 创建lighthouse@VM-8-10-ubuntu:git_learning$ git tag v1.0# 使用 git tag 查看所有标签 lighthouse@VM-8-10-ubuntu:git_learning$ git tagv1.0

③ 默认标签是打在最新提交的 commit 上的。那如何在指定的 commit上打标签呢?方法是找到历史提交的commit id,然后打上就可以了,示例如下:

# commit 历史记录lighthouse@VM-8-10-ubuntu:git_learning$ git log --pretty=oneline --abbrev-commitd80980f (HEAD -> master, tag: v1.0, origin/master, origin/HEAD) gitignore 配置15730c3 add .gitignore314e885 update file.txt.acd13ab create file.txt7ce19f5 Initial commit# 指定 Initial commit 的标签lighthouse@VM-8-10-ubuntu:git_learning$ git tag v0.9 7ce19f5lighthouse@VM-8-10-ubuntu:git_learning$ git tagv0.9v1.0
  • 注意:标签不是按时间顺序列出,而是按字母排序的

可以用 git show [tagname] 查看标签信息

lighthouse@VM-8-10-ubuntu:git_learning$ git show v1.0commit d80980f12ad7d73148be5691baa76c6272e8096c (HEAD -> master, tag: v1.0, origin/master, origin/HEAD)Author: island0920 <island0920@163.com>Date: Wed Apr 9 14:45:12 2025 +0800 gitignore 配置diff --git a/.gitignore b/.gitignoreindex 2df647c..4cf7e25 100644--- a/.gitignore+++ b/.gitignore@@ -2,3 +2,10 @@ *.ini *.so

Git还提供可以创建带有说明的标签,用 -a 指定标签名,-m 指定说明⽂字,格式为:

git tag -a [name] -m \"XXX\" [commit_id]

另外,打完标签之后,使用 tree.git 命令查看一下你的本地库有什么变化

└── refs ├── heads │ └── master ├── remotes │ └── origin │ ├── HEAD │ └── master └── tags ├── v0.9 └── v1.0

3. 操作标签

如果标签打错了,也可以删除:

lighthouse@VM-8-10-ubuntu:git_learning$ git tagv0.9v1.0lighthouse@VM-8-10-ubuntu:git_learning$ git tag -d v0.9Deleted tag \'v0.9\' (was 7ce19f5)

本地删除

因为创建的标签都只存储在本地,不会自动推送到远程。所以,打错的标签可以在本地安全删除

如果要推送某个标签到远程,使用命令 git push origin

lighthouse@VM-8-10-ubuntu:git_learning$ git tagv1.0lighthouse@VM-8-10-ubuntu:git_learning$ git push origin v1.0Total 0 (delta 0), reused 0 (delta 0), pack-reused 0remote: Powered by GITEE.COM [1.1.5]remote: Set trace flag e04547b4To gitee.com:island0920/git_learning.git * [new tag] v1.0 -> v1.0

此时,查看远端码云,看到了标签已经被更新!完美

当然,同样的我们也可以一次性推送所有标签到远端,如下:

git push origin --tags

远端删除

① 如果标签已经推送到远程,要删除远程标签就麻烦⼀点,先从本地删除:

lighthouse@VM-8-10-ubuntu:git_learning$ git tagv1.0lighthouse@VM-8-10-ubuntu:git_learning$ git tag -f v1.0lighthouse@VM-8-10-ubuntu:git_learning$ git tag -d v1.0Deleted tag \'v1.0\' (was d80980f)lighthouse@VM-8-10-ubuntu:git_learning$ git push origin :refs/tags/v1.0remote: Powered by GITEE.COM [1.1.5]remote: Set trace flag 024918b7To gitee.com:island0920/git_learning.git - [deleted] v1.0

【Git#5】远程操作 & 标签管理