Skip to content

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 在无标签时回退到哈希。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表