首页/开发/CI/CD 与发布速查/git describe 生成版本描述
构建与制品管理58 条

git describe 生成版本描述

基于最近标签生成可读描述(如 v1.8.0-12-gabc1234):表明距离上个版本多少个提交、当前提交是什么。

CI/CD 与发布速查开发更新于 2026-10-12
基本用法git describe --tags
常用参数--always(无标签时用 SHA)、--dirty(标记未提交改动)、--match 'v*'(限定标签模式)
输出解读v1.8.0-12-gabc1234 = 距 v1.8.0 有 12 个提交,当前提交 abc1234

示例

示例
git describe --tags --match 'v*' --always
git describe --tags --dirty
git -C repo describe --tags $(git -C repo rev-list -n1 v1.8.0)
构建脚本可据此生成「版本+提交数」的开发版本号,替代手写。

易错点

  • 仓库里标签缺失:describe 退化为一串 SHA,版本规则失效,先规范打标
  • 浅克隆(--depth=1)没有历史:describe 无法计算,构建时拉取标签与必要历史

数据来源与参考

  • git 文档《git-describe》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌