版本号设计

版本号的目标不是“好看”，而是让调用方快速判断兼容性和升级风险。

Semantic Versioning

版本号通常写成 X.Y.Z，也就是 Major.Minor.Patch。

• X：主版本号，表示不兼容变更
• Y：次版本号，表示向后兼容的新功能
• Z：修订号，表示向后兼容的问题修复

基本规则

1. X、Y、Z 必须是非负整数，且不应有前导零。
2. 0.Y.Z 表示仍在快速迭代阶段，API 可能不稳定。
3. 出现不兼容变更时，X 递增，同时 Y 和 Z 清零。
4. 新增兼容功能时，Y 递增，同时 Z 清零。
5. 修复兼容性问题时，Z 递增。
6. 已发布版本不应直接修改内容，应通过新版本交付。

预发布与开发版本

• 1.0.0.a1：alpha
• 1.0.0.b1：beta
• 1.0.0.rc1：release candidate
• 1.0.1.dev4：开发版本

常见后缀

• alpha：内部测试阶段
• beta：公测阶段
• demo：演示版
• lts：长期维护版本
• snapshot：快照版本
• release：正式发行版
• rc：准正式版

系统设计里的意义

版本号设计通常会影响：

• API 兼容策略
• SDK 发布策略
• 灰度与回滚
• 文档维护与升级提示