如何在Azure Pipeline中通过GitTools手动递增SemVer版本？

1. 检查GitVersion核心配置 #

• 确认配置文件GitVersion.yml中开启了commit message驱动的版本递增：
  • 确保模式设置为mode: Mainline（ContinuousDeployment模式默认不会通过commit message触发版本变更）
  • 移除手动设置的next-version配置项（如果存在），该项会覆盖自动递增逻辑，强制固定版本号

2. 修正Commit Message格式 #

• 移除commit message中的多余引号，确保semver标签能被GitTools正确识别，正确命令示例：

  git commit -a -m "+semver: patch [skip azurepipelines]" --allow-empty
  

• 建议将semver标签放在message开头，避免其他后缀干扰识别，简化测试命令：

  git commit -a -m "+semver: patch" --allow-empty
  

3. 确认分支与Git历史状态 #

• 确保当前操作分支是GitVersion配置指定的主分支（如main/master），Mainline模式下feature分支的版本递增仅在合并到主分支后生效
• 执行git tag检查现有标签，确认v1.1.1是最新的有效版本标签，无更高版本标签干扰计算

4. 重新触发GitVersion计算 #

• 提交commit后，手动执行GitVersion命令验证结果，避免缓存旧值：

  dotnet gitversion /output json
  

• 在Azure Pipelines中，确保GitVersion任务在commit操作之后执行，禁用版本结果缓存

5. 验证GitTools版本兼容性 #

• 升级到GitTools稳定版（v5.x及以上），旧版本可能存在commit message识别逻辑的兼容性问题

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