使用Gradle Zoltu Git-Versioning插件遇标签识别问题求助

以下是针对该问题的排查和解决步骤：

• 检查标签类型：该插件可能仅识别带注释的Git标签，轻量标签会被忽略。执行git show v0.1查看标签类型：

  • 如果输出仅显示标签名称，说明是轻量标签，需要重新创建带注释的标签：

    git tag -a v0.1 -m "Version v0.1"
    # 若需覆盖原有标签，添加-f参数：git tag -a -f v0.1 -m "Version v0.1"
    

• 确认插件配置的标签前缀：在构建脚本（如build.gradle）中，需显式指定标签前缀为v，确保插件能匹配到你的标签格式：

  gitVersioning {
      tagPrefix = 'v'
      // 其他版本规则配置...
  }
  

• 确保标签在仓库中完全可达：执行git log --oneline --decorate，确认HEAD所在提交是v0.1标签的后代或直接指向该标签的提交。若标签在独立分支上，需切换到对应分支或合并标签所在提交到当前分支。

• 同步仓库标签：如果是在CI环境或新克隆的仓库，执行git fetch --tags确保本地仓库拉取了所有远程标签；本地开发环境也可执行该命令刷新标签缓存。

• 排查版本兼容性：

  • 尝试升级com.zoltu.git-versioning到最新稳定版，避免旧版本的标签识别bug；
  • 检查本地Git版本，确保使用2.20及以上版本，部分旧Git版本的标签读取逻辑可能与插件不兼容。

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