Question

我们可以创建一个 tag 来指向软件开发中的一个关键时期，比如版本号更新的时候可以建一个“v2.0”、“v3.1”之类的标签，这样在以后回顾的时候会比较方便。tag 的使用很简单，主要操作有：查看 tag、创建 tag、验证 tag 以及共享 tag。

查看 tag

列出所有 tag：

git tag

这样列出的 tag 是按字母排序的，和创建时间没关系。如果只是想查看某些 tag 的话，可以加限定：

git tag -l v1.*

这样就只会列出 1.几的版本。

创建 tag

创建轻量级 tag：

git tag v1.0

这样创建的 tag 没有附带其他信息，与之相应的是带信息的 tag：

git tag -a v1.0 -m 'first version'

-m 后面带的就是注释信息，这样在日后查看的时候会很有用，这种是普通 tag，还有一种有签名的 tag：

git tag -s v1.0-m 'first version'

前提是你有 GPG 私钥，把上面的 a 换成 s 就行了。除了可以为当前的进度添加 tag，我们还可以为以前的 commit 添加 tag：

#首先查看以前的 commit
git log --oneline
#假如有这样一个 commit：8a5cbc2 updated readme
#这样为他添加 tag
git tag -a v1.18a5cbc2

里程碑无非也是一个引用，通过记录提交 ID（或者创建 Tag 对象）来为当前版本库的状态进行“留影”。

$ls .git/xefs/tags/<tag_name>

.git/refs/tags/<tag_name>


$ git rev-parse refs/tags/<tag_name>

41bd4e2cce0f8baa9bb4cdda62927b408c846cd6

删除 tag

很简单，知道 tag 名称后：

git tag -d v1.0

$ git push origin --delete ​ 删除 tag 这么用： $ git push origin --delete tag ​

验证 tag

如果你有 GPG 私钥的话就可以验证 tag：

git tag -v v1.0
git push origin :v1.1
//也可以这样
git push origin --delete tag V1.1

共享 tag

我们在执行 git push 的时候，tag 是不会上传到服务器的，比如现在的 github，创建 tag 后 git push，在 github 网页上是看不到 tag 的，为了共享这些 tag，你必须这样：

git push origin --tags
git push origin v1.1

描述历史

留过影之后，可以执行 git describe 命令将最新提交显示为一个易记的名称。显示的时候会选取离该提交最近的里程碑作为 基础版本号，后面附加标识距离“基础版本”的数字，以及该提交的 SHAI 哈希值缩写。因为最新的提交上恰好被打了一个 里程碑，所以直接显示 里程碑 的名称。这个技术会在后面的示例代码中多次用到。

$ git describe

输出的格式是

<tag_name>-<commit_times_after_this_tag>-<current_commit_id>

如果打完 tag 立即输出，将只会显示 tag 的名字。

想要在查看 log 时,同时输出 tag 信息，可以在 Log 中增加 --decoreate 参数。该参数还会输出分支信息。