未做任何改动时git describe命令返回异常值且无法获取最新标签

• 默认git describe仅匹配附注标签（annotated tag），*轻量标签（lightweight tag）*不会被检索到，只有加--tags参数才会同时检索轻量标签
• 同提交多标签的优先级问题：如果同一提交绑定了多个标签，git默认返回创建时间更早的标签，不会自动按版本号大小排序返回最新版本
• 本地标签缓存未同步：本地仓库存储的标签列表不是远端最新版本，导致检索不到最新推送的1.0.25标签
• 标签提交可达性问题：如果1.0.25标签绑定的提交不在当前HEAD的提交链上，自然无法被检索到

1. 同步远端全量标签到本地
   执行命令：

git fetch origin --tags --force

加--force参数可覆盖本地存在的同名旧标签，解决远端标签更新后本地未同步的问题

2. 验证标签类型
   执行命令查看1.0.25标签的类型：

git cat-file -t 1.0.25

• 返回tag说明是附注标签，符合默认git describe的检索要求
• 返回commit说明是轻量标签，必须加--tags参数才能被检索到

3. 验证标签提交的分支可达性
   执行命令查看1.0.25绑定的提交ID：

git rev-parse 1.0.25^{commit}

再执行命令验证该提交是否在当前分支的提交链中：

git branch --contains <上一步输出的提交ID>

如果输出列表没有当前所在分支，说明1.0.25标签绑定的提交不在当前分支，无法被git describe检索到
4. 配置标签匹配规则强制返回最高版本
如果同一提交绑定了多个标签，通过--match和排序参数强制返回版本号最高的标签，同时禁用长格式输出：

git describe --tags --match "1.0.*" --abbrev=0

如果团队统一使用轻量标签打版本，可配置git别名简化操作：

git config --global alias.get-ver 'describe --tags --match "1.0.*" --abbrev=0'

后续直接执行git get-ver即可直接输出当前分支最新匹配的版本标签

内容的提问来源于stack exchange，提问作者Julian