17.7　里程碑命名规范

在正式项目的版本库管理中，要为里程碑创建订立一些规则，诸如：

对创建里程碑进行权限控制，参考后面Git服务器架设的相关章节。

不要使用轻量级里程碑（只用于本地临时性里程碑），而是要使用带说明的里程碑，甚至要求必须使用带签名的里程碑。

如果使用带签名的里程碑，可以考虑设置专用账户，使用专用的私钥创建签名。

里程碑的命名要使用统一的风格，并很容易和最终产品显示的版本号相对应。

Git的里程碑命名还有一些特殊的约定需要遵守。实际上，下面的这些约定对于下一章要介绍的分支及任何其他引用均适用：

不要以符号“-”开头。以免在命令行中被当成命令的选项。

可以包含路径分隔符“/”，但是路径分隔符不能位于最后。

使用路径分隔符创建tag实际上会在引用目录下创建子目录。例如名为demo/v1.2.1的里程碑，就会创建目录.git/refs/tags/demo并在该目录下创建引用文件v1.2.1。

不能出现两个连续的点“..”。因为两个连续的点被用于表示版本范围，当然更不能使用三个连续的点。

如果在里程碑命名中使用了路径分隔符“/”，就不能在任何一个分隔路径中以点“.”开头。这是因为里程碑在用简写格式表达时，可能造成以一个点“.”开头。这样的引用名称在用作版本范围的最后一个版本时，本来两点操作符变成了三点操作符，从而造成歧义。

不能在里程碑名称的最后出现点“.”。否则作为第一个参数出现在表示版本范围的表达式中时，本来版本范围表达式可能用的是两点操作符，结果被误作三点操作符。

不能使用特殊字符，如：空格、波浪线“～”、脱字符“^”、冒号“:”、问号“?”、星号“*”、方括号“[”，以及字符\177（删除字符）或小于\040（32）的Ascii码都不能使用。

这是因为波浪线“～”和脱字符“^”都用于表示一个提交的祖先提交。冒号被用作引用表达式来分隔两个不同的引用，或者用于分隔引用代表的树对象和该目录树中的文件。问号、星号和方括号在引用表达式中都被用作通配符。

不能以".lock"为结尾。因为以".lock"结尾的文件是里程碑操作过程中的临时文件。

不能包含“@{”字串。否则易和reflog的"@{＜num＞}"语法相混淆。

不能包含反斜线“\”。因为反斜线用于命令行或shell脚本会造成意外。

Git还专门为检查引用名称是否符合规范提供了一个命令：git check-ref-format。若该命令返回值为0，则引用名称符合规范，若返回值为1，则不符合规范。

1.Linux中的里程碑

Linux内核项目无疑是使用Git版本库时间最久远，也是最重量级的项目。研究Linux内核项目本身的里程碑命名和管理，无疑会为自己的项目提供借鉴。

（1）首先看看Linux中的里程碑命名。可以看到里程碑都是以字母v开头。

（2）以-rc＜num＞为后缀的是先于正式版发布的预发布版本。

可以看出这个里程碑是一个带签名的里程碑。关于此里程碑的说明也是再简练不过了。

（3）正式发布版去掉了预发布版的后缀。

（4）正式发布后的升级/修正版本是通过最后一位数字的变动来体现的。

2.Android项目

看看其他项目的里程碑命名，会发现不同项目关于里程碑的命名各不相同。但是对于同一个项目要在里程碑命名上遵照同一标准，并能够和软件版本号正确地对应。

Android项目是一个非常有特色的使用Git版本库的项目，在后面会用两章介绍Android项目为Git带来的两个新工具。看看Android项目的里程碑编号对自己版本库的管理有无启发。

（1）看看Android项目中的里程碑命名，会发现其里程碑的命名格式为android-＜大版本号＞_r＜小版本号＞。

（2）里程碑的创建过程中使用了专用账号和GnuPG签名。