| 默认 | 基于可达的附注标签 |
|---|---|
| --tags | 也接受轻量标签 |
| --always | 无标签可用时输出短哈希；--dirty 标记脏工作区 |
常用示例
常用示例
git describe --tags
git describe --tags --always --dirty
git describe --long
git describe --match 'v1.*'流水线把 describe 结果写进构建产物版本号，可精确追溯到某个提交。
git describe 生成可读版本号
用标签描述任意提交：输出「标签-距离-短哈希」形式，--dirty 标记工作区有改动，常用于构建号与版本标识。
易错点
- 浅克隆历史不全时可能找不到标签，先补历史或改用 --always
- 默认只认附注标签，只有轻量标签时加 --tags 才能被描述
数据来源与参考
- Git 官方文档：git-describe