像其他版本控制系统一样,Git 可以给历史中的某一个提交点打上标签,以示重要。 比如功能开发完成后会使用这个功能来标记发布节点(如 v1.0 等)。本篇,就介绍下如何创建、删除标签等操作。
Tag 会指向一个 commit,就像一个分支的引用,但是不会变化(永远都指向同一个 commit,仅仅提供了一个更加友好的名字)
创建标签
Git 标签分为两种类型:轻量标签(lightweight)与附注标签(annotated)
- 轻量标签:指向提交对象的引用(就像一个独立的分支)
- 附注标签:仓库中一个独立的对象,还可以查看标签的信息(推荐使用)
标签的信息:标签的名字、邮箱地址和日期、标签说明等。
轻量标签
轻量标签本质上是将提交校验和存储到一个文件中 —— 没有保存任何其他信息。
创建轻量标签,不需要传递参数,直接指定标签名即可 git tag <tagname>
如:git tag v1.0
附注标签
在 Git 中创建一个附注标签,需添加参数
git tag -a <tagname> -m <message>
-
-a
即 annotated 的缩写,指定标签类型,后面跟上标签名 -
-m
选型指定了标签的说明,如果没有给出该选项,Git 会启动文本编辑器供你输入标签说明。
打完标签之后,查看日志也能看到所打标签
列出标签
在 Git 中列出已有的标签是非常简单直观的。 只需要输入 git tag
即可
这个命令以字母顺序列出标签,但是它们出现的顺序并不重要。
Git 也支持列出符合特定模式的标签
例如,如果只关心对 0.x,可以运行:git tag -l 'v0.*'
这里支持 windows系统命令行中存在的最简单的正则表达式
- * 任意长度的字符串
- ?长度为1的任意字符串
查看标签
通过使用 git show <tagname>
命令可以看到标签信息与对应的提交信息:
- 使用附注标签(exp:tag v0.2) 输出显示了打标签者的信息、打标签的日期时间、附注信息,然后显示具体的提交信息
-
使用轻量标签(exp:tag v0.1)不会看到额外的标签信息
补打标签
前面的打标签方式,都针对当前提交处,Git 也支持对过去的提交打标签。 要在那个提交上打标签,只需要在命令的末尾指定提交commitid即可
- 轻量标签
git tag <tagname> <commitid>
- 附注标签
git tag -a <tagname> -m <message> <commitid>
现在,假设在 “feat_6 modify ”处, alpha版本 时你忘记给项目打标签,那么可以补打标签
git tag -a v0.1_alpha -m "release aplha 0.1" 35b473
可以看到已经在那次提交上打上标签了:
分享标签(推送到远程)
默认情况下,git push
并不会把标签推送到远端服务器上,只有通过显式命令才能分享标签到远端仓库。其命令格式如同推送分支,执行 git push origin <tagname>
即可:
在 GitHub 也看到有一个标签
点进去可看到标签详情
如果要一次推送所有(本地新增的)标签上去,可以使用 --tags
选项:
git push origin --tags
那么远程端会同步所有未 push 过的标签。
现在,当其他人从仓库中 clone 或者 pull,也能看到这些远程标签
删除标签
要删除掉你本地仓库上的标签,可以使用命令 git tag -d <tagname>
。例如,可以使用下面的命令删除掉一个标签:
需要注意上述命令并不会远程仓库中移除这个标签,你必须使用 git push <remote> :refs/tags/<tagname> 来更新你的远程仓库:
删除远程仓库中的 v0.1 标签 git push origin :refs/tags/v0.1
这里的<remote> 是origin,其实每个本地仓库也可以有多个远程仓库的
检出标签(切换标签)
如果你想查看某个标签所指向的文件版本,可以使用 git checkout <tagname>
命令,Git 会检出指定版本,但是并没有在分支内。这叫做一个 "detacthed HEAD",会使仓库处于“分离头指针”状态,这意味着 HEAD 文直接指向一个提交,而不是一个符号引用。
我们从 v0.1_alpha 检出 git chckout v0.1_alpha
当前从标签 v0.1_alpha 检出的并不是一个新的分支,而是一个分离头指针状态
在 “分离头指针” 状态下,如果做了某些更改然后提交它们,标签不会发生变化,但你的新提交将不属于任何分支,并且将无法访问,除非确切的提交哈希。因此,如果你需要进行更改——比如说你正在修复旧版本的错误——这通常需要创建一个新分支:
git checkout -b <new_branch>
当然,如果在这之后又进行了一次提交,这个分支会因为这个改动向前移动,新分支就会和 v0.1_alpha 标签稍微有些不同。
参考理解:我自己会将 detacthed HEAD state 理解成一个灰色地带,能够单独检出,但是做的事情无法保存,最好回到分支上处理
回顾总结
本篇介绍了 tag 命令的使用,良好的使用 tag 能够更直观的进行版本管理
创建标签
-
git tag <tagname>
创建轻量标签 -
git tag -a <tagname> -m <message>
创建附注标签(推荐)
列出标签
-
git tag [-l]
列出标签 -
git tag -l [tagname]
列出指定模式的标签,可以用简单的正则,如 v0.*
查看标签
-
git show <tagname>
查看指定标签
补打标签
-
git tag <tagname> <commitid>
补打轻量标签 -
git tag -a <tagname> -m <message> <commitid>
补打附注标签
分享标签(远程标签)
-
git push origin <tagname>
本地标签推送至远端 -
git push origin --tags
推送所有的本地标签至远端
删除标签
-
git tag -d <tagname>
删除本地标签 -
git push <remote> :refs/tags/<tagname>
删除远端标签
检出标签
-
git checkout <tagname>
但不建议直接在检出后环境(分离头指针状态)更新,通常会创建新分支来处理,但 tag 的指向不会变化
系列文章传送门
Git 入门系列(一)- Git 概念/安装/基本操作/远程推送更新
Git 入门系列(二)- 修改管理 / 撤销操作 / 命令及区间关系
Git 入门系列(三)- 分支(上)创建与切换 / 合并 / 查看 / 删除
Git 入门系列(四)- 分支(下)合并解决冲突 / 远程分支
Git 入门系列(五)- stash 贮藏
Git 入门系列(六)- 标签 tag
Git 入门系列(七)- 可视化 Git 管理工具
Git 入门系列(八) - FAQ
欢迎关注个人公众号,【程序媛春哥的手记】