在使用 Git 版本控制的过程中,会产生大量的版本。如果我们想对某些重要版本进行记录,就可以给仓库历史中的某一个commit 打上标签,用于标识。
在本章中,我们将会学习如何列出已有的标签、如何创建和删除新的标签、以及标签的类型。
事实上,标签只是用来记录某一个「commit 对象」的 hash 值,以一个比较好记的名称来帮助我们记住某个版本。
Git 支持两种标签:轻量标签(lightweight)与附注标签(annotated)。
tag 相关的文件在 .git/refs/tag 文件夹中,文件名就是 tag 名。
轻量标签很像一个不会改变的分支 —— 它只是某个特定「commit 对象」的引用。
但是如果我们通过 git cat-file -p
而标注标签则是一个 git 对象,在 git 中的概念 文章介绍了 Git 中存在的 4 种对象。
附注标签对象包含打标签者的名字、电子邮件地址、日期时间, 此外还有一个标签信息,并且可以使用 GNU Privacy Guard (GPG)签名并验证。
通常会建议创建附注标签,这样我们可以拥有以上所有信息,并且可以永久保存在 .git 文件夹中(储存到仓库中的 Git 对象都是不变的,只有索引才是变动的)。但是如果我们只是想用一个临时的标签, 或者因为某些原因不想要保存这些信息,那么也可以用轻量标签。
从上图可以看到 beta-v1.1 文件的内容与最新「commit 对象」的 hash 值不同,这时通过 cat-file 命令就可以发现这个 hash 值对应的是一个「tag 对象」:
可以看到「tag 对象」内存在一个对象 hash 值,就是最新「commit 对象」的 hash 值,第二行的 type commit 就是介绍上一行的对象的类型是一个「commit 对象」,这代表我们也可以把任何 Git 对象都建立成一个标签对象。
git tag
-a 会将当前的 HEAD 指针指向的版本建立成「tag 对象」,如果要将其他特定对象建立为标签的用法为 git tag
创建标签的命令非常简单,就是 git tag
git tag
假设我们要为第一次的 commit 添加一个标签,可以执行 git tag -a
使用 git tag 可以查看所有的标签:
按照通配符列出标签需要 -l 或 --list 选项
如果我们只想要完整的标签列表,那么运行 git tag 就会默认假定我们想要一个列表,它会直接给我们列出来, 此时的 -l 或 --list 是可选的。
然而,如果我们提供了一个匹配标签名的通配模式,那么 -l 或 --list 就是强制使用的。
而使用 git show
要删除掉我们本地仓库上的标签,可以使用命令 git tag -d
注意上述命令并不会从任何远程仓库中移除这个标签
默认情况下,git push 命令并不会传送标签到远程仓库上。 在创建完标签后我们必须显式地推送标签到远程仓库。 这个过程就像推送分支一样 —— 我们可以运行 git push origin
如果想要一次性推送很多标签,也可以使用 git push origin --tags (带上 --tags 参数)。 这将会把所有不在远程仓库上的标签全部推送上去。
跟新增标签一样,我们在删除标签时,也只是在本地仓库上进行操作,也需要推送到远程仓库中才能删除远程仓库中的标签:
使用 git push origin --delete
如果我们想查看某个标签所指向的文件版本,可以使用 git checkout
若想查询 git tag 的完整用法,可执行 git help tag 即可显示完整的文件说明。
文章仓库地址:https://github.com/leopord-lau/easy-git