语义化版本控制
1. 语义化版本控制核心规则
Section titled “1. 语义化版本控制核心规则”语义化版本格式为:MAJOR.MINOR.PATCH(主版本号.次版本号.修订号),其版本号递增规则如下:
- 主版本号 (MAJOR): 当你做了 不兼容的 API 修改 时递增。
- 次版本号 (MINOR): 当你以 向下兼容的方式新增了功能 时递增。
- 修订号 (PATCH): 当你做了 向下兼容的错误修复 (Bug Fixes) 时递增。
2. 规则详解与使用建议
Section titled “2. 规则详解与使用建议”2.1. 主版本号 (MAJOR)
Section titled “2.1. 主版本号 (MAJOR)”- 当 API 的公共接口发生破坏性变更(Breaking Changes),导致旧的依赖客户端无法直接升级时,必须递增
MAJOR版本,并将MINOR和PATCH清零(例如从1.5.2升级到2.0.0)。 - 在
0.y.z阶段(即大版本号为 0),系统处于初始开发阶段,API 随时可能发生变化,此时的0.y.z变更不需要严格遵循MAJOR不兼容的规则。
2.2. 次版本号 (MINOR)
Section titled “2.2. 次版本号 (MINOR)”- 当引入了新的公共 API、弃用了某些旧 API(Deprecation),或者在内部代码中实现了显著的新功能,但 确保现有 API 接口依旧保持兼容 时,必须递增
MINOR版本,并将PATCH清零(例如从1.5.2升级到1.6.0)。
2.3. 修订号 (PATCH)
Section titled “2.3. 修订号 (PATCH)”- 仅用于向下兼容的缺陷修复(Bug Fixes)。这指的是没有新增公共 API,也没有修改已有公共 API 的内部代码修正(例如从
1.5.2升级到1.5.3)。