tagging
与大多数版本控制系统一样,Git具有将存储库历史中的特定点标记为重要tag的能力。通常,人们使用此功能来标记发布点(例如v1.0,v2.0等)。在本节中,将学习如何列出现有的标签,如何创建和删除标签,以及不同类型的标签是什么。
显示tag列表
该命令按字母顺序列出标签;它们显示的顺序没有真正的重要性。
还可以搜索与特定模式匹配的标签。例如
PS:
列出标签通配符需要使用 -l 或 --list 选项。
如果只想要整个标签列表,运行 git tag 命令会隐式地假设我们想要一个列表,并提供一个在这种情况下,使用 -l 或 --list 是可选的。
然而,如果提供了一个通配符模式来匹配标签名称,那么使用 -l 或 --list 是强制的。
创建标签
Git支持两种类型的标签:轻量级标签和附注标签。
轻量级标签非常类似于不会改变的分支------它只是指向特定提交的指针。
然而,附注标签存储为Git数据库中的完整对象, 他们是经过校验的,包含标签者的姓名、电子邮件和日期,有一个标签消息,并且可以使用GNU隐私保护(GPG)进行签名和验证。通常建议创建附注标签,以便可以获取所有这些信息
但如果需要一个临时标签或出于某种原因不想保留其他信息,轻量级标签也是可用的。
辅助标签
在Git中创建一个附注标签很简单。最简单的方法是在运行tag命令时指定 -a。
-m 参数指定了一个与标签一起存储的标签消息。如果没有为附注标签指定消息,Git会启动编辑器,以便输入消息。
可以使用 git show 命令查看标签数据以及被标记的提交。
这会显示标签者信息、标签日期以及注释信息,然后再显示提交信息。
轻量级标签
另一种打标签的方法是使用轻量级标签。这基本上就是将校验和存储在文件中 - 没有保留其他信息。要创建轻量级标签,不要提供任何 -a、-s 或 -m 选项,只需提供一个标签名称。
这一次,如果在标签上运行 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
Change version number
后期打签
可以针对某一commit id打签,我简单测试用仓库的提交历史如下:
可以针对commit id 7db1252补打标签,如下
推送标签到远程服务器
默认情况下,git push 命令不会将标签传输到远程服务器。在创建标签后,需要显式地将标签推送到共享服务器。这个过程就像更新远程分支一样 - 可以运行 git push origin <tagname>。
如果有很多标签需要一次性推送到远程,也可以使用 git push 命令的 --tags 选项。这将传输所有尚未存在于远程服务器上的标签。
删除标签
要在本地仓库中删除一个标签,可以使用 git tag -d <tagname> 命令。例如
请注意,这不会从任何远程服务器中删除标签。删除远程服务器上的标签有两种常见的变体。
第一种变体是 git push <remote> :refs/tags/<tagname>。
解释上述命令的方式是将冒号前的空值推送到远程标签名称,从而有效地删除它。
第二种(更直观的)删除远程标签的方法是使用
$ git push origin --delete <tagname>
检出标签
如果想查看标签对应的那个软件版本,可以通过 git checkout 来检出该标签,请留意这会将仓库置于 "detached HEAD" 状态,这会带来一些不良的副作用。
在 "detached HEAD" 状态下,如果进行更改然后创建一个提交,标签将保持不变,但新的提交将不属于任何分支,并且无法送达(除了通过确切的commit 哈希)。因此,如果需要进行更改,比如说要修复一个旧版本的 bug,通常会想要创建一个分支。
如果这样做并进行了提交,v2.0 分支将会与v2.0 标签略有不同,因为它将随着新更改向前移动,所以务必小心。