Git应用详解第八讲:Git标签、别名与Git gc

时间:2023-03-08 16:44:04
Git应用详解第八讲:Git标签、别名与Git gc

前言

前情提要:Git应用详解第七讲:Git refspec与远程分支的重要操作

这一节主要介绍Git标签、别名与Git的垃圾回收机制。

一、Git标签(tag)

1.标签的实质

标签与分支十分相似,都是指向某一次提交;并且,它们的值都为各自指向提交的SHA1值;但是,不同于会随着提交的变化而变化的分支,一旦给某次提交添加了标签,该标签就永远不会发生变化。

注意:标签标识的是某一次提交,这次提交可以是任何分支上的任何一次提交。

两类标签

Git标签有两种:

  • 轻量级标签lightweight):不可添加注释;
  • 带有附注的标签annotated):可以添加注释;

Annotated tags are meant for release while lightweight tags are meant for private or temporary object labels.

以上是git官方文档对两种标签的说明,大意是:带注释的标签用于发布,而轻量级标签则用于私人或临时对象。

什么时候打标签呢?

  • 版本发布:一般master分支都会作为项目的发布分支,当项目开发到了一个成熟的阶段,准备在master分支进行发布时。一般都会在master分支的当前提交上打上一个类似"v1.2"的标签;

    比如Vue框架:

    Git应用详解第八讲:Git标签、别名与Git gc

    可以看到有许多标签,并且可以在releases选项中查看标签和发布版本:

    Git应用详解第八讲:Git标签、别名与Git gc

  • 版本管理:可以通过标签的形式记录项目某一阶段的状态,方便管理;

    比如管理学习微信小程序时每个知识点的代码:

    Git应用详解第八讲:Git标签、别名与Git gc

查看标签文件

如下图所示,分别给master分支的提交mas2添加一个轻量级标签v1.0和一个带有附注的标签v2.0

Git应用详解第八讲:Git标签、别名与Git gc

git doggit log --all --decorate --oneline --graph的别名,后面会讲解;

随后,查看存储标签文件的.git/refs/tags目录:

Git应用详解第八讲:Git标签、别名与Git gc

可以看到:

  • tags目录下存储着添加的标签文件v1.0v2.0
  • 分别打开标签文件v1.0v2.0,它们的值都是一个SHA1值,并且与添加标签时所在提交mas2SHA16920a6e...相等。
  • emm...等等!并不相等呀,只有v1.0的值与提交mas2SHA1值相等,而与v2.0的值并不相等!
  • 为什么给同一次提交mas2添加的标签,它们的SHA1值会不相等呢?这是因为v1.0是轻量级标签,而v2.0是带有附注的标签。

虽然两个标签标记的都是同一次提交,但是它们的构造不一样:

  • 轻量级标签v1.0直接将这次提交的SHA1值作为自己的SHA1值;

  • 而带附注的标签v2.0会创建一个tag对象,它的SHA1值是tag对象的SHA1值;

这就是轻量级标签与带有附注标签的区别。不过这两个标签仍然会指向同一次提交,如下图所示:

Git应用详解第八讲:Git标签、别名与Git gc

2.创建标签

git tag <tag_name>

创建一个轻量级标签:

Git应用详解第八讲:Git标签、别名与Git gc

git tag -a <tag_name> -m '注释'

创建一个带有附注的标签:

Git应用详解第八讲:Git标签、别名与Git gc

3.查看标签

git tag

显示添加的所有标签:

Git应用详解第八讲:Git标签、别名与Git gc

也可以添加--list参数:

Git应用详解第八讲:Git标签、别名与Git gc

如下图所示:切换了分支tag仍然存在,说明tag与分支并没有关系,它标识的是某次特定的提交:

Git应用详解第八讲:Git标签、别名与Git gc

git show <tag_name>

如图所示,在master分支上进行两次提交,每次为文件test.txt添加一行内容并且打上标签。其中v1.0为轻量级标签,v2.0为带有附注的标签:

Git应用详解第八讲:Git标签、别名与Git gc

随后,使用git show查看标签的内容:

  • 轻量级标签:

    Git应用详解第八讲:Git标签、别名与Git gc

    如图所示,该指令会显示标签v1.0所指向的提交;并且,会输出标签指向提交与上一次提交的比较结果;由于标签v1.0指向的提交为master分支的第一次提交,所以上一次提交为null。因此比较结果显示:相比于上一次提交,标签指向的提交1st在文件test.txt中新增了一行1st

  • 带注释的标签:

    Git应用详解第八讲:Git标签、别名与Git gc

    相比于轻量级标签,带附注的标签是一个对象,可以存储附注和打标签的人和时间等信息,所以显示的信息多一些;从图中的比较结果可知,相比于上一次提交1st,标签v2.0指向的提交2nd为文件test.txt新增了一行2nd

4.查找标签

git tag -l <tag_name>

该方式支持正则表达式查找;

Git应用详解第八讲:Git标签、别名与Git gc

如上图所示:

  • v*表示搜索所有以v开头的标签;
  • ?2*表示搜索任意开头,但包含2的标签;

5.将标签推送到远程

要将标签推送到远程仓库,首先要建立本地仓库与远程仓库的联系,比如可以采用:

git push -u origin master

建立本地master分支与远程master分支的联系,并进行一次推送:

Git应用详解第八讲:Git标签、别名与Git gc

git push origin <tag_name>

这种方法可以推送指定的本地标签到远程仓库,例如将本地master分支上的标签v1.0推送到远程仓库:

Git应用详解第八讲:Git标签、别名与Git gc

执行上述指令后,对应的远程仓库gitTest中就会出现相应的tag信息了:

Git应用详解第八讲:Git标签、别名与Git gc

也可以在releases选项中,查看tagReleases信息:

Git应用详解第八讲:Git标签、别名与Git gc

Git应用详解第八讲:Git标签、别名与Git gc

也可以同时推送多个本地标签到远程仓库

git push origin  v2.0 v3.0

Git应用详解第八讲:Git标签、别名与Git gc

以上的命令都是简写形式,完整写法为:

git push origin refs/tags/v4.0:refs/tags/v4.0

Git应用详解第八讲:Git标签、别名与Git gc

git push origin --tag

该方法可以一次性推送所有的本地标签到远程仓库:

Git应用详解第八讲:Git标签、别名与Git gc

也可以采用简写命令:

//下面的tag可以写成tags,效果一样
git push --tag

Git应用详解第八讲:Git标签、别名与Git gc

6.删除远程标签

当然,我们可以直接在远程仓库上删除远程标签。但是,最好的方式还是采用命令行进行删除。删除远程标签的方法与删除远程分支的方法非常类似,同样有两种方法:

git push origin :<tag_name>

这种方法相当于推送一个空的标签到远程仓库,由此达到删除的效果。比如删除远程仓库中的标签v3.0

git push origin :v3.0

Git应用详解第八讲:Git标签、别名与Git gc

这样远程仓库中的标签V3.0就被删除了:

Git应用详解第八讲:Git标签、别名与Git gc

但是本地仓库中对应的标签V3.0并没有被删除:

Git应用详解第八讲:Git标签、别名与Git gc

上述指令为简写,完整写法如下

git push origin :refs/tags/v3.0

Git应用详解第八讲:Git标签、别名与Git gc

git push origin --delete <tag_name>

该方法采用了更加语义化的参数--delete,实现远程标签的删除:

git push origin --delete v2.0

Git应用详解第八讲:Git标签、别名与Git gc

同样成功地删除了远程仓库中的标签v2.0

Git应用详解第八讲:Git标签、别名与Git gc

但是,本地的标签v2.0也没有被删除:

Git应用详解第八讲:Git标签、别名与Git gc

采用下列的完整写法,效果是一样的:

git push origin --delete tag v2.0

Git应用详解第八讲:Git标签、别名与Git gc

不难发现,删除远程分支远程标签的方法是一样的。

7.删除本地标签

git tag -d <tag_name>

如通过以下命令删除标签v3.0

git tag -d v3.0

Git应用详解第八讲:Git标签、别名与Git gc

8.切换标签

git checkout <tag_name>

如图所示,在master分支上进行了三次提交,并且添加了相应的标签:

Git应用详解第八讲:Git标签、别名与Git gc

当我们通过checkout命令切换到标签v2.0时:

Git应用详解第八讲:Git标签、别名与Git gc

可见,会出现游离的提交。此时查看各分支状态:

Git应用详解第八讲:Git标签、别名与Git gc

如上图所示,当前处于标签v2.0指向的提交,并且切换标签的过程中改变了HEAD指针的指向。但是,并没有改变分支master的指向。过程如下图所示:

Git应用详解第八讲:Git标签、别名与Git gc

也就是说,切换标签与使用reset进行版本回退十分相似。只不过切换标签只改变了HEAD指针的指向,会造成游离的提交。若有需要可以创建一个新分支进行保存。

9.拉取标签

在下图所示的情况中,本地仓库mygit与远程仓库有公共的提交历史(同源),并且不发生合并冲突的情况下(具体可参考Git应用详解第六讲:Git协作与Git pull常见问题):

Git应用详解第八讲:Git标签、别名与Git gc

可以直接通过git pull将远程仓库的标签拉取下来,并创建本地仓库中没有的标签:

Git应用详解第八讲:Git标签、别名与Git gc

二、Git别名

1.设置git命令别名

git config <作用域> alias.<别名> '<命令>'

别名就是一个替代,使用一个简短的字符串来代替常用的长命令。比如可以通过如下命令,使用别名bra来替代branch命令:

git config --global alias.bra branch

Git应用详解第八讲:Git标签、别名与Git gc

当命令较为简短时,可以省略命令两边的单引号:

Git应用详解第八讲:Git标签、别名与Git gc

在上述命令中:

  • --global表示设置的别名作用域为系统用户,即该用户对所有的git仓库都可以使用这个别名;其余还有仓库作用域--loacl,系统作用域--system

  • alias.br表示更改别名为br

  • 再往后的branch表示需要起别名的命令,可以是带参数的长命令,此时不能省略命令两边的单引号:

    git config --global alias.dog 'log --all --decorate --oneline --graph'

    Git应用详解第八讲:Git标签、别名与Git gc

由于上面配置的别名作用域为系统用户,该配置会写入gitconfig配置文件。打开该文件可以看到写入的别名配置

补充:使用vi ~/.gitconfig可以直接打开gitconfig这个文件(记得加点),无论当前所处的路径是什么;

Git应用详解第八讲:Git标签、别名与Git gc

也就是说可以直接通过修改gitconfig文件的alias选项来设置别名,但是不建议

这样,通过别名就可以简化一些常用的命令了,比如git statusgit checkout等:

Git应用详解第八讲:Git标签、别名与Git gc

2.设置外部命令别名

gitk这样的外部命令,是没有git前缀的。设置别名的方法与设置git提供的命令有所不同,要按照如下格式设置:

git config <作用域> alias.<别名> '<!外部命令>'
  • 感叹号表示这是一个外部命令;
  • 注意要加上单引号,不用加git前缀;

比如在系统用户作用域下,将git ui设置为gitk的别名:

 git config --global alias.ui '!gitk'

设置完成后,该配置会被写入系统用户的配置文件gitconfig中:

Git应用详解第八讲:Git标签、别名与Git gc

随后直接使用git ui便能打开gitk界面:

Git应用详解第八讲:Git标签、别名与Git gc

补充:设置了别名后,原来的命令仍然有效。

三、垃圾回收:Git gc

所谓gc就是垃圾回收机制,实际使用较少;它的作用是清理不必要的文件并优化本地存储库

为了演示它的作用,设置以下测试环境:

  • 首先,在本地仓库mygit创建masterdev两个分支,并将它们推送到远程仓库:

    Git应用详解第八讲:Git标签、别名与Git gc

  • 然后,给本地仓库mygit添加一个轻量级标签v1.0和一个带有附注的标签v2.0

    Git应用详解第八讲:Git标签、别名与Git gc

此时.git/refs目录下的各文件如下所示:

Git应用详解第八讲:Git标签、别名与Git gc

heads目录存储的是本地分支信息,remote目录存储的是远程分支信息,tags目录存储的是标签信息,符合预期。

随后,执行git gc命令:

Git应用详解第八讲:Git标签、别名与Git gc

再次查看.git/refs目录:

Git应用详解第八讲:Git标签、别名与Git gc

可以看到refs目录及其子目录下的文件消失了,但是.git目录下多了一个packed-refs文件。事实上,refs目录下的文件不是消失了,而是被打包到了packed-refs文件中。打开packed-refs文件:

Git应用详解第八讲:Git标签、别名与Git gc

可以看到执行git gcrefs目录及其子目录下的文件都被压缩打包packed-refs文件中了。从图中可以看到轻量级标签v1.0只占一行,而带附注的标签v2.0占两行:

  • 其中第6行和第8行的SHA1值是相同的,这是因为两个标签都是给同一次提交上添加的;
  • 而带附注的标签v2.0中的另外一行信息(第7行)表示的则是tag对象的SHA1值;

打包完之后,再次修改文件,或者添加分支,新增的内容还是会在.git/refs目录下显示,而不会被打包到packed-refs文件中,需要重新执行git gc才会被打包。

以上就是本节的全部内容,经过这一节的学习,相信你已经能够熟练运用Git标签和别名来提高开发效率了。下一节将会详细介绍git cherry-pickgit rebase,我们下一节再见!