17.2.2　带说明的里程碑

带说明的里程碑，就是使用参数-a或-m＜msg＞调用git tag命令，在创建里程碑的时候提供一个关于该里程碑的说明。下面来看看如何创建带说明的里程碑：

（1）还是先创建一个空提交。

$git commit—allow-empty-m "blank commit for annotated tag test."

[master 8a9f3d1]blank commit for annotated tag test.

（2）在刚刚创建的空提交上创建一个带说明的里程碑，名为mytag2。

下面的命令使用了-m＜msg＞参数，在命令行给出了新建里程碑的说明。

$git tag-m "My frst annotated tag." mytag2

（3）查看里程碑，可以看到该里程碑已经创建。

$git tag-l my*-n1

mytag blank commit.

mytag2 My first annotated tag.

下面来看看带说明里程碑的奥秘。当创建了带说明的里程碑mytag2后，会在版本库的.git/refs/tags目录下创建一个新的引用文件。

查看一下这个引用文件的内容：

$cat.git/refs/tags/mytag2

149b6344e80fc190bda5621cd71df391d3dd465e

用git cat-file命令检查该里程碑（带说明的里程碑）指向的对象，会发现指向的不再是一个提交，而是一个tag对象。

$git cat-file-t mytag2

tag

查看该提交的内容，会发现mytag2对象的内容不是之前我们熟悉的提交对象的内容，而是包含了创建里程碑时的说明，以及对应的提交ID等信息。

$git cat-file-p mytag2

object 8a9f3d16ce2b4d39b5d694de10311207f289153f

type commit

tag mytag2

tagger user1＜user1@sun.ossxp.com＞Sun Jan 2 14:10:07 2011+0800

My first annotated tag.

由此可见使用带说明的里程碑，会在版本库中建立一个新的对象（tag对象），这个对象会记录创建里程碑的用户（tagger），创建里程碑的时间，以及为什么要创建里程碑。这就避免了轻量级里程碑因为匿名创建而无法追踪的缺点。

带说明的里程碑是一个tag对象，在版本库中以一个对象的方式存在，并用一个40位的SHA1哈希值来表示。这个哈希值的生成方法和前面介绍的commit对象、tree对象、blob对象一样。至此，Git对象库的四类对象我们就都已经研究到了。

$git cat-file tag mytag2|wc-c

148

$(printf "tag 148\000";git cat-file tag mytag2)|sha1sum

149b6344e80fc190bda5621cd71df391d3dd465e-

虽然mytag2本身是一个tag对象，但在很多Git命令中，可以直接将其视为一个提交。下面的git log命令，显示mytag2指向的提交日志。

$git log-1—pretty=oneline mytag2

8a9f3d16ce2b4d39b5d694de10311207f289153f blank commit for annotated tag test.

有时，需要得到里程碑指向的提交对象的SHA1哈希值。

直接用git rev-parse命令查看mytag2得到的是tag对象的ID，并非提交对象的ID。

$git rev-parse mytag2

149b6344e80fc190bda5621cd71df391d3dd465e

使用下面几种不同的表示法，则可以获得mytag2对象所指向的提交对象的ID。

$git rev-parse mytag2^{commit}

8a9f3d16ce2b4d39b5d694de10311207f289153f

$git rev-parse mytag2^{}

8a9f3d16ce2b4d39b5d694de10311207f289153f

$git rev-parse mytag2^0

8a9f3d16ce2b4d39b5d694de10311207f289153f

$git rev-parse mytag2～0

8a9f3d16ce2b4d39b5d694de10311207f289153f