推送标签后GitVersion生成2.0.1而非2.0.0的原因及解决方法

在GitVersion的Mainline模式下，核心设计逻辑是：标签代表已发布的稳定版本，若分支当前提交被判定为“标签之后的新变更”——哪怕只是标签推送后触发工作流时，工作目录未切换到标签对应的提交——GitVersion会按配置的增量类型（此处为Patch）自动生成下一个版本，也就是2.0.1。

另外，若GitHub Actions工作流触发标签推送事件时，未明确切换到标签指向的提交，而是默认检出主分支HEAD（即便HEAD和标签指向同一个提交，部分场景下GitVersion仍会判定为“待发布的增量变更”），也会导致生成2.0.1而非标签对应的2.0.0。

要实现“推送标签后首次生成对应标签版本（如2.0.0），后续提交增量为2.0.1、2.0.2……”的效果，可通过以下两步调整：

1. 调整GitHub Actions的代码检出逻辑
   使用actions/checkout时，明确指定检出标签对应的提交，而非默认的分支HEAD。修改工作流中的checkout步骤：

   - name: Checkout code
     uses: actions/checkout@v4
     with:
       ref: ${{ github.ref }}  # 触发标签推送事件时，检出标签指向的提交
       fetch-depth: 0  # 必须拉取完整Git历史，否则GitVersion无法正确计算版本
   

2. 优化GitVersion配置
   在GitVersion.yml配置文件中添加规则，确保当前提交存在匹配的版本标签时，直接返回标签版本，不自动增量：

   mode: Mainline
   branches:
     main:
       increment: Patch
       track-merge-target: false
   ignore:
     sha: []
   # 条件规则：当前提交有版本标签时，不增量版本
   conditional:
     - condition: IsTagged
       increment: None
       label: ''
   

配置完成后，推送v2.0.0标签时，工作流会检出标签对应的提交，GitVersion识别到该提交已标记为v2.0.0，直接返回2.0.0；后续main分支的新提交，GitVersion会自动增量补丁版本到2.0.1、2.0.2等。

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