Git 系列教程（9）- 打标签

打标签

一般会给提交历史打个标签，方便后续进行筛选、查看

列出标签

可带上可选的 -l 选项 --list

$ git tag

v1.0

v2.0

这个命令以字母顺序列出标签

可以按照特定的模式查找标签

例如，Git 代码仓库包含标签的数量超过 500 个，只想查 v1.8.5 相关的内容

$ git tag -l "v1.8.5*"

v1.8.5

v1.8.5-rc0

v1.8.5-rc1

v1.8.5-rc2

v1.8.5-rc3

v1.8.5.1

v1.8.5.2

v1.8.5.3

v1.8.5.4

v1.8.5.5

标签的分类

Git 支持两种标签

轻量标签（lightweight）
附注标签（annotated）

轻量标签

很像一个不会改变的分支，它只是某个特定提交的引用

附注标签

是存储在 Git 数据库中的一个完整对象，它们是可以被校验的
其中包含打标签者的名字、电子邮件地址、日期时间，此外还有一个标签信息，并且可以使用 GNU Privacy Guard （GPG）签名并验证
通常会建议创建附注标签，这样可以拥有以上所有信息
但是如果你只是想用一个临时的标签，或者因为某些原因不想要保存这些信息，那么也可以用轻量标签。

附注标签相关命令

创建附注标签

在运行 tag 命令时指定 -a 选项

$ git tag -a v1.4 -m "my version 1.4"

$ git tag

v0.1

v1.3

v1.4

-m 选项指定了一条将会存储在标签中的信息，如果不加，就会要求你手动输入

查看标签信息和提交信息

通过使用 git show 命令可以看到标签信息和与之对应的提交信息

$ git show v1.4

tag v1.4

Tagger: Ben Straub <ben@straub.cc>

Date:   Sat May 3 20:19:12 2014 -0700

my version 1.4

commit ca82a6dff817ec66f44342007202690a93763949

Author: Scott Chacon <schacon@gee-mail.com>

Date:   Mon Mar 17 21:52:11 2008 -0700

    changed the version number

输出显示了打标签者的信息、打标签的日期时间、附注信息，然后显示具体的提交信息

轻量标签相关命令

本质上是将提交校验和（SHA，那串很长的乱码）存储到一个文件中，没有保存任何其他信息

创建轻量标签

不需要使用 -a、-s 或 -m 选项，只需要提供标签名字

$ git tag v1.4-lw

$ git tag

v0.1

v1.3

v1.4

v1.4-lw

v1.5

这时，如果在标签上运行 git show，你不会看到额外的标签信息。命令只会显示出提交信息

$ git show v1.4-lw

commit ca82a6dff817ec66f44342007202690a93763949

Author: Scott Chacon <schacon@gee-mail.com>

Date:   Mon Mar 17 21:52:11 2008 -0700

    changed the version number

后期打标签

也可以对提交历史打标签

实际栗子

假设提交历史是这样的

$ git log --pretty=oneline

15027957951b64cf874c3557a0f3547bd83b3ff6 Merge branch 'experiment'

a6b4c97498bd301d84096da251c98a07c7723e65 beginning write support

0d52aaab4479697da7686c15f77a3d64d9165190 one more thing

6d52a271eda8725415634dd79daabbc4d9b6008e Merge branch 'experiment'

0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc added a commit function

4682c3261057305bdd616e23b64b0857d832627b added a todo file

166ae0c4d3f420721acbb115cc33848dfcc2121a started write support

9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile

964f16d36dfccde844893cac5b347e7b3d44abbc commit the todo

8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme

现在，假设在 v1.2 时你忘记给项目打标签，也就是在 “updated rakefile” 的提交历史

补打标签

你可以在之后补上标签。要在那个提交上打标签，你需要在命令的末尾指定提交的校验和（或部分校验和）

git tag -a v1.2 9fceb02

查看补打标签的信息

$ git tag

v0.1

v1.2

v1.3

v1.4

v1.4-lw

v1.5

$ git show v1.2

tag v1.2

Tagger: Scott Chacon <schacon@gee-mail.com>

Date:   Mon Feb 9 15:32:16 2009 -0800

version 1.2

commit 9fceb02d0ae598e95dc970b74767f19372d61af8

Author: Magnus Chacon <mchacon@gee-mail.com>

Date:   Sun Apr 27 20:43:35 2008 -0700

    updated rakefile

...

共享标签

默认情况下，git push 命令并不会传送标签到远程仓库服务器上
在创建完标签后你必须显式地推送标签到远程仓库上

推送标签的语法格式

git push <remote> <tagname>

实际栗子

polo@B-J5D1MD6R-2312 watermarker % git push origin2 1.11

枚举对象中: 17, 完成.

对象计数中: 100% (17/17), 完成.

使用 12 个线程进行压缩

压缩对象中: 100% (12/12), 完成.

写入对象中: 100% (14/14), 1.47 KiB | 1.47 MiB/s, 完成.

总共 14（差异 6），复用 0（差异 0），包复用 0

remote: Powered by GITEE.COM [GNK-5.0]

To gitee.com:poloyy/watermarker.git

 * [new tag]         1.11 -> 1.11

一次性推送过个标签

如果想要一次性推送很多标签，也可以使用带有 --tags 选项的 git push 命令。这将会把所有不在远程仓库服务器上的标签全部传送到那里。

git push origin2 --tags

枚举对象中: 6, 完成.

对象计数中: 100% (6/6), 完成.

使用 12 个线程进行压缩

压缩对象中: 100% (4/4), 完成.

写入对象中: 100% (5/5), 452 字节 | 452.00 KiB/s, 完成.

总共 5（差异 2），复用 0（差异 0），包复用 0

remote: Powered by GITEE.COM [GNK-5.0]

To gitee.com:poloyy/watermarker.git

 * [new tag]         1.2 -> 1.2

 * [new tag]         1.3 -> 1.3

现在，当其他人从仓库中克隆或拉取，他们也能得到这些标签

删除标签

删除掉本地仓库上的标签，加个 -d 就行

polo@B-J5D1MD6R-2312 watermarker % git tag

1.11

1.2

1.3

testbu

v1.1

polo@B-J5D1MD6R-2312 watermarker % git tag -d 1.11

已删除标签 '1.11'（曾为 9baca61）

polo@B-J5D1MD6R-2312 watermarker % git tag -d 1.2

已删除标签 '1.2'（曾为 e4da7ac）

polo@B-J5D1MD6R-2312 watermarker % git tag -d 1.3

已删除标签 '1.3'（曾为 bf12eaa）

polo@B-J5D1MD6R-2312 watermarker % git tag

testbu

v1.1

-d 删除标签并不会从任何远程仓库中删除这个标签

删除远程仓库的标签

第一种，--delete

$ git push origin --delete <tagname>

简单粗暴的方式

栗子

polo@B-J5D1MD6R-2312 watermarker % git push origin2 --delete 1.2

remote: Powered by GITEE.COM [GNK-5.0]

To gitee.com:poloyy/watermarker.git

 - [deleted]         1.2

polo@B-J5D1MD6R-2312 watermarker % git push origin2 --delete 1.3

remote: Powered by GITEE.COM [GNK-5.0]

To gitee.com:poloyy/watermarker.git

 - [deleted]         1.3

第二种，传空值

git push <remote> :refs/tags/<tagname>

将冒号前面的空值推送到远程标签名，从而高效地删除它

栗子

polo@B-J5D1MD6R-2312 watermarker % git push origin2 :refs/tags/1.11

remote: Powered by GITEE.COM [GNK-5.0]

To gitee.com:poloyy/watermarker.git

 - [deleted]         1.11

checkout 标签

如果想查看某个标签所指向的文件版本，可以使用 git checkout 命令
但仓库处于“分离头指针（detached HEAD）”的状态，会有些小问题存在

polo@B-J5D1MD6R-2312 watermarker % git status

头指针分离于 testbu

无文件要提交，干净的工作区

checkout 的栗子

polo@B-J5D1MD6R-2312 watermarker % git checkout testbu

注意：正在切换到 'testbu'。

您正处于分离头指针状态。您可以查看、做试验性的修改及提交，并且您可以在切换

回一个分支时，丢弃在此状态下所做的提交而不对分支造成影响。

如果您想要通过创建分支来保留在此状态下所做的提交，您可以通过在 switch 命令

中添加参数 -c 来实现（现在或稍后）。例如：

  git switch -c <新分支名>

或者撤销此操作：

  git switch -

通过将配置变量 advice.detachedHead 设置为 false 来关闭此建议

HEAD 目前位于 7fa175d test

查看当前所处分支

polo@B-J5D1MD6R-2312 watermarker % git branch

* （头指针在 1.2 分离）

  master

能看到执行 git checkout 之后，本地分支会自动切换到头指针分支

重点

在“分离头指针”状态下，如果做了某些更改然后提交它们，标签不会发生变化
但新提交将不属于任何分支，并且将无法访问，除非通过确切的提交哈希才能访问，看下面的实际栗子

polo@B-J5D1MD6R-2312 watermarker % git push

fatal: 您当前不在一个分支上。

现在为推送当前（分离头指针）的历史，使用

    git push origin HEAD:<远程分支名字>

需要指定远程分支的哈希（就是那串很长的乱码字符串）

因此，如果你需要进行更改，比如你要修复旧版本中的错误，那么通常需要创建一个新分支

polo@B-J5D1MD6R-2312 watermarker % git checkout -b newtest3 1.2

切换到一个新分支 'newtest3'

polo@B-J5D1MD6R-2312 watermarker % git branch

  master

  newtest2

* newtest3