GitVersion 6.0版本配置变更与解决方案

GitVersion是一个流行的.NET版本控制工具，它可以根据Git提交历史自动生成语义化版本号。随着GitVersion 6.0的发布，一些配置方式发生了变化，这可能导致从5.x版本升级时遇到兼容性问题。

问题背景

在从GitVersion 5.12.0升级到6.0.2版本时，用户遇到了配置解析错误。错误信息显示"Requested value 'MainLine' was not found"，这表明新版本对配置模式的处理方式发生了变化。

配置变更分析

GitVersion 6.0对配置模式进行了重构，移除了旧版本中的"MainLine"模式。这实际上是GitVersion团队对配置系统进行简化和优化的结果。在5.x版本中，"MainLine"模式用于在主分支上自动创建每个版本，但在6.0版本中，这种行为需要通过其他方式实现。

解决方案

经过测试验证，新的有效配置方案如下：

mode: ManualDeployment
major-version-bump-message: "^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\\([\\w\\s-,/\\\\]*\\))?(!:|:.*\\n\\n((.+\\n)+\\n)?BREAKING CHANGE:\\s.+)"
minor-version-bump-message: "^(feat)(\\([\\w\\s-,/\\\\]*\\))?:"
patch-version-bump-message: "^(build|chore|ci|docs|fix|perf|refactor|revert|style|test)(\\([\\w\\s-,/\\\\]*\\))?:"
workflow: TrunkBased/preview1

配置说明

1. mode: 设置为ManualDeployment模式，这提供了更精细的版本控制能力
2. 版本提升规则:
   • 主版本提升(major): 当提交信息包含BREAKING CHANGE或使用!标记时
   • 次版本提升(minor): 当提交类型为feat(新功能)时
   • 补丁版本提升(patch): 对于修复(fix)、性能优化(perf)等不影响功能的变更
3. workflow: 使用TrunkBased/preview1工作流，适合主干开发模式

升级建议

对于从5.x升级到6.x的用户，建议：

1. 仔细检查现有配置文件中是否有过时的配置项
2. 参考官方文档了解6.0版本的配置变更
3. 在测试环境中验证新配置后再应用到生产环境
4. 考虑使用ManualDeployment模式以获得更精确的版本控制

总结

GitVersion 6.0的配置变更反映了项目向更清晰、更灵活的版本控制方向发展的趋势。虽然升级过程中可能需要调整配置，但新版本提供了更强大的功能和更清晰的配置语义。理解这些变更并相应调整配置，可以确保平稳过渡到新版本。