Git 标签简介

发布一个版本时,我们通常先在版本库中打一个标签(tag),这样,就唯一确定了打标签时刻的版本。将来无论什么时候,取某个标签的版本,就是把那个打标签的时刻的历史版本取出来。所以,标签也是版本库的一个快照。
Git 的标签虽然是版本库的快照,但其实它就是指向某个commit的指针(跟分支很像,但是分支可以移动,标签不能移动),所以创建和删除标签都是瞬间完成的。

tag命令

我们知道Git已经有commit了,可以用来查询版本,之所以又加入一个tag命令来查询版本是因为commit号是一长串数字,查找起来非常不方便。而假如说用tag的话,就可以用起的标签名例如v1.0.1代替了一长串的commit号,同时记忆起来也是十分的方便。

tag命令创建标签

首先切换到需要打标签的分支上,使用命令git tag <name>就可以打一个新标签。

查看标签

可以用命令git tag查看所有标签。

如何给gitlab打tag gitlab tag_github


默认标签是打在最新提交的commit上的。有时候,如果忘了打标签,我们可以通过git log --pretty=oneline --abbrev-commit找到历史提交的commit id,然后打上标签

如何给gitlab打tag gitlab tag_github_02

Git标签排序

注意,标签不是按时间顺序列出,而是按字母排序的。可以用git show查看标签信息,如下图所示:

如何给gitlab打tag gitlab tag_github_03

Git标签添加说明

与commit类似,tag命令也可以创建带有说明的标签,用-a指定标签名,-m指定说明文字:

git tag -a 标签名 -m "标签说明"

如何给gitlab打tag gitlab tag_如何给gitlab打tag_04

标签删除
git tag -d 标签名

如何给gitlab打tag gitlab tag_github_05

推送标签到远程仓库

推送某一个标签
如果要推送某个标签到远程,使用命令git push origin 标签名推送全部标签
一次性推送全部尚未推送到远程的本地标签git push origin --tags
删除推送到远程标签
首先从本地删除git tag -d 标签名,然后从远程删除,

git push origin :refs/tags/标签名
含附注标签

上面介绍到的标签都只是 git 标签中的一种,叫轻量级的标签(lightweight),轻量级标签就像是个不会变化的分支,实际上它就是个指向特定提交对象的引用。
另外一种 git 标签叫含附注的标签(annotated),附注标签实际上是存储在仓库中的一个独立对象,它有自身的校验和信息,包含着标签的名字,电子邮件地址和日期,以及标签说明,标签本身也允许使用 GNU Privacy Guard (GPG) 来签署或验证。一般我们都建议使用含附注型的标签,以便保留相关信息;当然,如果只是临时性加注标签,或者不需要旁注额外信息,用轻量级标签也没问题。

创建一个含附注类型的标签非常简单,用 -a (译注:取 annotated 的首字母)指定标签名字即可:

git tag -a v4.0 -m '标签说明'

如果你有自己的私钥,还可以用 GPG 来签署标签,只需要把之前的选项 -a 改为 -s (译注: 取 signed 的首字母)即可:

git tag -s v5.0 -m '标签说明'

总结

1、命令 git tag 标签名用于新建一个标签,默认为HEAD,也可以指定一个commit id;
2、命令git tag -a 标签名 -m "标签说明" 可以指定标签信息;
3、命令git tag可以查看所有标签;
4、命令git tag -d 标签名删除标签;
5、命令git push origin 可以推送一个本地标签;
6、命令git push origin --tags可以推送全部未推送过的本地标签;
7、命令git push origin :refs/tags/可以删除一个远程标签;
8、命令git tag -a -m 'messages’可以创建一个带附注的标签;
9、命令git tag -s -m 'messages’可以创建一个带 gpg 签名的标签;