GitVersion项目中的SemVer版本号生成问题解析

问题背景

在GitVersion 6.0.0版本中，用户在使用GitVersion.MSBuild工具为.NET 8可打包项目生成版本号时遇到了问题。生成的SemVer版本号格式不符合预期，导致构建失败。具体表现为工具生成的FullSemVer格式为"0.6.0-HYP-719_update_gitversion.1+27"，而构建系统期望的是"0.6.0-HYP-719_update_gitversion.1"。

技术分析

SemVer规范要求

Semantic Versioning(SemVer)规范对版本号格式有严格要求：

1. 主版本号.次版本号.修订号
2. 预发布标签(可选)：以连字符连接，可包含字母数字和连字符
3. 构建元数据(可选)：以加号连接

问题出在分支名称中的下划线字符"_"上。GitVersion 6.0.0开始允许分支名中包含下划线，而之前版本会自动将下划线转换为连字符"-"。

版本号生成机制

GitVersion根据分支名称生成预发布标签时：

• 在6.0.0之前：自动将下划线替换为连字符
• 6.0.0版本：保留原始下划线字符

这导致生成的版本号中包含下划线，而NuGet包版本规范不允许下划线字符，从而引发构建错误。

解决方案

GitTools团队在6.0.1版本中修复了此问题，恢复了下划线到连字符的自动转换行为。用户可以通过以下方式解决：

1. 升级到GitVersion 6.0.1或更高版本
2. 或者修改分支命名规范，避免使用下划线字符

最佳实践建议

1. 分支命名规范：建议使用连字符"-"而非下划线"_"作为单词分隔符
2. 版本控制策略：明确项目的版本控制模式(ContinuousDelivery/ContinuousDeployment)
3. 配置文件优化：在gitversion.yml中明确定义分支策略和标签格式
4. 版本号验证：在CI/CD流程中加入版本号格式验证步骤

技术影响

此问题不仅影响NuGet包构建，还可能影响：

• Docker镜像标签
• 程序集版本
• 其他依赖严格SemVer格式的工具链

理解GitVersion的版本号生成机制对于建立可靠的持续交付流程至关重要。开发团队应当充分测试版本号生成结果，确保与构建系统的兼容性。