git - 如何使用 Git 的 `describe` 命令导出应用程序构建版本字符串？

Question

我想编写应用程序构建版本，该版本自动派生 self 所在的 Git 分支名称(构建时)和自分支发生分歧以来的提交次数。我相信这对于我的 Git 存储库中的任何提交都是独一无二的？分支名称是唯一的，并且提交沿着分支相互链接？如果以及当我标记提交时，我还可以让版本以该标记为前缀。

在某种程度上 git describe 做我想做的事，但它不包括我所在的分支名称，它包括缩写的提交 SHA-1 哈希，我认为我不需要因为它不会给字符串的熵增加任何东西并且可能是多余的(我在这里可能是错的，所以请纠正我)。

我有哪些选择？我在这里的思考方向是否正确？当我在软件开发方面有更重要的事情要处理时，我有点厌倦了在版本上附加数字。

顺便说一句，我从不使用肮脏的工作树进行构建。 IE。我总是在构建公开版本之前提交对存储库的更改。

Answer 1

关于 git，您需要了解的一点是，分支本质上只是提交书签。当您进行 0deadbeef 提交时，您在 foo 分支上这一事实对提交本身并不重要；分支不是其身份的一部分。

(Mercurial 将分支名称烘焙到提交中。In a variety of ways, this is inferior, as Dustin Sallings explains。)

即使假设 git describe 只会使用当前 check out 的分支——如果你有 merge 历史，可能会有多个路径指向 git describe 的相同的最新标记提交 会使用。所以甚至不一定有任何一个分支。

另一个注意事项:您可能会反对，即使“来自标签 X 的第 3 次提交”在一般情况下是模棱两可的，git describe 也可以只查看图表并弄清楚它是否 不明确，如果不明确，则省略散列。但是，没有什么可以阻止任何人稍后在该标记之上开始分支 - 因此您的 describe 字符串将变得不明确追溯。

最重要的是，提交的唯一明确标识符是它的散列。所以那一定是在里面。 git describe 所做的是添加一些冗余(并且在提交编号的情况下，是模棱两可的)信息，使描述对人类的空间/关系理解更有用在 Git 模型的范围内定位自己。