GitFlow场景下如何用GitVersion将版本从0.1.0升级至1.0.0？

一、规则存在的原因 #

GitVersion的这个限制是严格遵循**语义化版本（SemVer）**的核心约定：0.x.y属于预发布开发阶段，意味着软件功能尚未稳定、公共API可能随时变更。SemVer明确规定，0.x系列的所有迭代都属于破坏性变更范畴，无需通过主版本号升级来标识——主版本号保留为0，所有版本演进都通过次版本号体现。GitVersion默认实现了这个逻辑，因此即便使用主版本升级关键字，也只会触发次版本号提升。

二、实现升级至1.0.0的可行方案 #

1. 手动强制指定版本号 #

在合并develop到main分支的流程中，直接通过GitVersion命令行参数锁定目标版本：

gitversion /updateassemblyinfo /version 1.0.0

在CI/CD流水线中，也可以配置对应的参数让GitVersion输出1.0.0版本。这种方式直接高效，适合完成正式版本里程碑的一次性升级。

2. 修改GitVersion配置文件 #

编辑项目根目录的GitVersion.yml，调整版本升级规则，允许从0.x版本触发主版本号升级：

mode: Mainline
major-version-bump-message: '^(breaking|major|release 1\.0\.0)'

这里将主版本升级的触发条件设置为提交信息中包含breaking、major或release 1.0.0等关键字，同时确保模式为Mainline（适配GitFlow工作流）。也可以添加ignore: minor-version-bumps-when-major-is-zero配置，彻底跳过0.x阶段的次版本自动提升逻辑。

3. 直接创建发布标签 #

完成develop到main的合并后，给main分支打上v1.0.0的版本标签：

git tag -a v1.0.0 -m "正式发布1.0.0版本"
git push origin v1.0.0

GitVersion会优先识别已存在的标签版本，后续的版本计算将基于1.0.0展开，完全符合GitFlow的发布规范。

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