GIT 中如何打标签(git tag)

2022年8月1日12:16:39

前言

在我们开发的过程中,可能经过多次 commit 提交才会确定一个版本,那么除了用 commit comments 来标识一次提交记录,还有没有什么更好的办法呢?GIT 为我们提供了标签这个功能,使用标签可以对某一次提交记录做上一个小标记,就像我们看书的时候,看到很有意思想要做个记号,可以用小的标签纸贴在那一页的边上,这让我们以后可以更方便的索引。


0x1 GIT 标签常用指令

GIT 中的标签分为两种,一种是轻量标签(lightweight tag),一种是附注标签(annotated tag)。以下是一些常用的与标签相关的命令:

  • git tag <lightweght_name>:为当前分支所在的提交记录打上轻量标签。
  • git tag <lightweght_name> <commit SHA-1 value>:为某次具体的提交记录打上轻量标签。
  • git tag -a <anotated_name> -m <tag_message>:为当前分支所在的提交记录打上附注标签。
  • git tag:列出所有的标签名。
  • git tag -d <tag_name>:删除某个标签,本质上就是移除.git/refs/tags/ 中对应的文件。
  • git show <tag_name>:显示标签对应提交记录的具体信息。
  • git push <remote> <tag_name>:推送某个标签到远程仓库。
  • git push <remote> --tags:推送所有标签到远程仓库。
  • git push <remote> --delete <tag_name>:删除远程仓库中的某个标签。

[注]:标签与分支不相关。


0x2 轻量标签

轻量标签的创建十分简单,使用命令git tag <lightweight_name> 则会为当前所在的提交记录打上一个轻量标签。那么这个命令会发生什么呢?其实很简单,在使用这个命令后,会在.git/refs/tags/ 目录下生成一个以<lightweight name> 为名字的文件,文件中存放了标签所对应提交记录的 commit 对象的 SHA-1 值。如下图所示:
GIT 中如何打标签(git tag)
假设我想为上述三个提交记录中的第一次提交打上版本 0 的标签,也是很容易做到的,同时使用git log 命令时也会显示出标签的名称:
GIT 中如何打标签(git tag)


0x3 附注标签

创建附注标签也非常简单,只要加上-a 选项即可。同时还可以通过-m 选项指定一条存储在标签中的信息,如果没有指定则 GIT 会打开编辑器要求你输入。假如我们为当前的提交记录打上一个附注标签,可以查看标签如下:
GIT 中如何打标签(git tag)
附注标签同样也在 .git/refs/tags/ 目录下生成对应的文件,但是这个文件中不再存储该标签对应的 commit 对象的 SHA-1 值,而是存放了一个称为 tag对象的 SHA-1 值,这个 tag 对象中就存储了与这个附注标签相关的信息(包括打标签者的名字、电子邮件地址、日期时间、一个标签信息)和这个标签所对应的 commit 对象的 SHA-1 值。 我们可以查看如下:
GIT 中如何打标签(git tag)


0x4 远程仓库中的标签

我们想想标签文件所在的文件夹和其中保存的信息,是不是觉得其和分支很像?这使得他也有一个特点,就是在我们使用git push 命令推送某个分支的时候,标签并不会被推送到远程仓库,所以我们必须显式的推送标签到远程仓库

使用下面两种命令则可以推送标签到远程仓库:

  • git push <remote> <tag_name>:推送某个标签到远程仓库。
  • git push <remote> --tags:推送所有标签到远程仓库。

同样,在删除本地的标签后,要想删除远程仓库的标签,也必须使用的显式的命令:

  • git push <remote> --delete <tag_name>:删除远程仓库中的某个标签。
  • git push <remote> :refs/tags/<tagname>:删除远程仓库某个标签的等价方式,相当于将冒号前面的空值推送到远程标签名,从而高效地删除它。
  • 作者:Grazie_
  • 原文链接:https://blog.csdn.net/qq_21746331/article/details/120776710
    更新时间:2022年8月1日12:16:39 ,共 1596 字。