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 会启动文本编辑器供你输入标签说明。

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

列出标签

在 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

欢迎关注个人公众号，【程序媛春哥的手记】