Git Describe
一句话解释
git describe 基于最近带注释标签为当前提交生成人类可读名称。
用大白话说
git describe 通过找到从提交可达的最近标签并计算其间提交数,为提交起人类可读名。例如最近标签是 v1.2.0 且其后有 5 个提交,则输出 v1.2.0-5-gabc1234。这对版本识别远比裸哈希有意义。它是从 Git 仓库生成版本字符串的标准方式:构建工具运行 git describe --tags --always 为未发布构建生成 1.2.0-5-gabc1234 之类版本,或提交恰为标签时仅 1.2.0。--always 在无标签时回退到哈希。在构建脚本、CI 与发布工具中用 git describe 把确切源版本嵌入二进制、日志与关于页。它适用于带注释标签(首选)或轻量标签(--tags),并可用 --match 限制搜索范围。
示例
bash
# At a commit 5 past the v1.2.0 tag
git describe
# v1.2.0-5-gabc1234
# At exactly a tag
git checkout v1.2.0
git describe
# v1.2.0
# Use lightweight tags too, fall back to hash if no tags
git describe --tags --always
# In a build script — embed the version
VERSION=$(git describe --tags --always)
echo "Building version $VERSION"describe 找最近标签、计数其后提交并追加短哈希:tag-N-gHASH。--always 在无标签时回退到哈希。
相关术语
相关资源
相关课程
- Git 进阶
学习 git describe。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。