GitVersion升级后PR阶段NuGet预发布版本未按semver规则递增

核心原因分析 #

GitVersion v1（对应工具v5+版本）在PR分支的版本计算逻辑和旧版v0（工具v4及以下）存在差异：PR分支默认不再直接应用commit消息中的semver指令，而是优先基于目标分支当前版本做补丁号递增，除非显式配置开启PR分支对commit消息semver规则的识别。

针对性配置修复 #

需调整GitVersion.yml中的关键配置，确保PR阶段能正确解析commit里的+semver指令：

1. 开启PR分支的semver消息识别
   添加或修改pull-request分支配置，明确启用commit消息驱动的版本递增：

   branches:
     pull-request:
       regex: ^(pull|pull\-requests|pr)[/-]
       mode: ContinuousDeployment
       tag: pullrequest
       increment: Inherit
       track-merge-target: true
       commit-message-incrementing: Enabled # 关键配置：开启commit消息semver解析
       label: '{BranchName}'
       source-branches: ['main', 'develop'] # 根据你的主分支名称调整
   

   重点是commit-message-incrementing: Enabled，v1版本中该配置默认可能为Disabled或MergeMessageOnly，导致PR分支忽略普通commit的semver指令。

2. 确认semver消息匹配规则
   确保commit-message-format能正确识别+semver:前缀的指令：

   commit-message-format:
     pattern: '(?<message>.*)(\+semver:(?<increment>major|minor|patch|none))'
     increment: Increment
   

   该规则会从commit消息中提取+semver: major/minor/patch指令，让GitVersion应用对应的版本递增逻辑。

3. 本地验证配置生效情况
   在PR分支本地运行以下命令，确认配置和版本计算结果：

   # 查看实际生效的配置
   gitversion /showconfig
   # 计算当前版本并输出详细信息
   gitversion /output json
   

   检查输出的FullSemVer字段是否符合预期版本格式。

额外注意事项 #

• GitVersion v1中track-merge-target默认设为true，会基于目标分支版本计算，但开启commit-message-incrementing后，commit消息的semver指令会覆盖默认的补丁递增逻辑。
• 确保PR分支的commit消息严格遵循+semver: major格式，无拼写错误（如大小写、冒号后空格缺失）。
• 若使用GitHub Actions，需确认gitversion/setup@1安装的是GitVersion v5.x及以上版本，且运行前已拉取完整git历史（包含所有相关commit），否则无法解析commit消息中的semver指令。

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