学新通技术网

【Git 入门系列】标签 tag 的使用

juejin 3 1
【Git 入门系列】标签 tag 的使用

前言

像其他版本控制系统一样,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 会启动文本编辑器供你输入标签说明。

image.png

打完标签之后,查看日志也能看到所打标签

image.png

列出标签

在 Git 中列出已有的标签是非常简单直观的。 只需要输入 git tag 即可 这个命令以字母顺序列出标签,但是它们出现的顺序并不重要。

Git 也支持列出符合特定模式的标签 例如,如果只关心对 0.x,可以运行:git tag -l 'v0.*'

image.png

这里支持 windows系统命令行中存在的最简单的正则表达式

    • 任意长度的字符串
  • ?长度为1的任意字符串

查看标签

通过使用 git show <tagname> 命令可以看到标签信息与对应的提交信息:

  • 使用附注标签(exp:tag v0.2) 输出显示了打标签者的信息、打标签的日期时间、附注信息,然后显示具体的提交信息
  • 使用轻量标签(exp:tag v0.1)不会看到额外的标签信息

image.png

补打标签

前面的打标签方式,都针对当前提交处,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

可以看到已经在那次提交上打上标签了:

image.png

分享标签(推送到远程)

默认情况下,git push 并不会把标签推送到远端服务器上,只有通过显式命令才能分享标签到远端仓库。其命令格式如同推送分支,执行 git push origin <tagname> 即可:

image.png

在 GitHub 也看到有一个标签

image.png

点进去可看到标签详情

image.png

如果要一次推送所有(本地新增的)标签上去,可以使用 --tags 选项:

git push origin --tags 那么远程端会同步所有未 push 过的标签。

image.png

image.png

现在,当其他人从仓库中 clone 或者 pull,也能看到这些远程标签

删除标签

要删除掉你本地仓库上的标签,可以使用命令 git tag -d <tagname>。例如,可以使用下面的命令删除掉一个标签:

image.png

需要注意上述命令并不会远程仓库中移除这个标签,你必须使用 git push <remote> :refs/tags/<tagname> 来更新你的远程仓库: 删除远程仓库中的 v0.1 标签 git push origin :refs/tags/v0.1

这里的<remote> 是origin,其实每个本地仓库也可以有多个远程仓库的

image.png

检出标签(切换标签)

如果你想查看某个标签所指向的文件版本,可以使用 git checkout <tagname> 命令,Git 会检出指定版本,但是并没有在分支内。这叫做一个 "detacthed HEAD",会使仓库处于“分离头指针”状态,这意味着 HEAD 文直接指向一个提交,而不是一个符号引用。

我们从 v0.1_alpha 检出 git chckout v0.1_alpha

image.png

当前从标签 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 的指向不会变化

本文出至:学新通技术网

标签: