GIT 中如何打标签（git tag）

---

前言

在我们开发的过程中，可能经过多次 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 值。如下图所示：

假设我想为上述三个提交记录中的第一次提交打上版本 0 的标签，也是很容易做到的，同时使用 git log 命令时也会显示出标签的名称：

---

0x3 附注标签

创建附注标签也非常简单，只要加上 -a 选项即可。同时还可以通过 -m 选项指定一条存储在标签中的信息，如果没有指定则 GIT 会打开编辑器要求你输入。假如我们为当前的提交记录打上一个附注标签，可以查看标签如下：

附注标签同样也在 .git/refs/tags/ 目录下生成对应的文件，但是这个文件中不再存储该标签对应的 commit 对象的 SHA-1 值，而是存放了一个称为 tag 对象的 SHA-1 值，这个 tag 对象中就存储了与这个附注标签相关的信息（包括打标签者的名字、电子邮件地址、日期时间、一个标签信息）和这个标签所对应的 commit 对象的 SHA-1 值。 我们可以查看如下：

---

0x4 远程仓库中的标签

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

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

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

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

• git push <remote> --delete <tag_name>：删除远程仓库中的某个标签。
• git push <remote> :refs/tags/<tagname>：删除远程仓库某个标签的等价方式，相当于将冒号前面的空值推送到远程标签名，从而高效地删除它。