升级Nuke中GitVersion至v6.0.0后NuGetVersion属性为空求助

可能的原因 #

1. GitVersion v6 API 变更
   GitVersion v6 对版本属性的命名和生成逻辑做了调整，旧版的NuGetVersion、NuGetVersion2可能已被重命名或需要通过新配置启用。比如v6中默认可能不再自动生成这两个属性，或者改用NuGetVersionV2、FullSemVer等替代字段。

2. Nuke 集成适配滞后
   如果使用的Nuke版本较旧，其内置的GitVersion模块可能未适配v6的新API，导致无法正确映射属性值，最终返回空值。

3. GitVersion 配置兼容性问题
   GitVersion v6 对配置文件（GitVersion.yml）的格式、参数要求更严格，旧配置可能导致版本计算逻辑失败，进而无法生成有效的NuGet版本号。

4. 分支/标签规则不匹配
   v6 对Git分支、标签的识别规则有调整，如果你的仓库分支命名、标签格式不符合v6的默认规则，可能导致版本计算中断，属性为空。

解决步骤 #

• 验证GitVersion独立运行结果
  在项目根目录直接执行GitVersion v6的命令：

dotnet gitversion

查看输出的JSON结果，确认是否存在NuGetVersion或替代字段（如NuGetVersionV2）。如果输出中没有这些字段，说明是GitVersion本身的配置问题，需要调整GitVersion.yml。

• 调整GitVersion配置
  如果独立运行也没有生成目标字段，修改GitVersion.yml，添加必要的配置项，比如：

mode: Mainline
branches:
  main:
    regex: ^main$|^master$
    tag: ''
    increment: Minor
    prevent-increment-of-merged-branch-version: true
    track-merge-target: false
    source-branches: []
    tracks-release-branches: false
    is-release-branch: false

确保配置符合v6的规则，触发版本号的正确生成。

• 升级Nuke到最新版本
  更新Nuke的包引用，确保使用的Nuke版本已适配GitVersion v6。NuGet包管理器中升级Nuke.Common到最新稳定版。

• 替换属性名称
  如果GitVersion v6中属性名已变更，将Nuke代码中的GitVersion.NuGetVersion替换为对应新属性，比如：

.SetVersion(GitVersion.NuGetVersionV2)
// 或者
.SetVersion(GitVersion.FullSemVer)

• 查看详细日志
  在Nuke构建脚本中启用GitVersion的详细日志，排查是否有错误信息：

GitVersionTasks.GitVersion(s => s
    .SetVerbosity(Verbosity.Detailed)
);

根据日志中的提示，解决分支识别、配置错误等问题。

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