软件版本号的编写需要遵循一定的规范和规则,以确保版本信息的清晰性和可管理性。以下是综合多个权威来源的版本号编写规范:
一、版本号结构
核心格式 版本号通常由四部分组成,采用“主版本号.次版本号.修订号”结构,例如:
```
1.2.3
```
其中:
- 主版本号:
标识不兼容的API修改;
- 次版本号:表示向下兼容的功能性新增;
- 修订号:记录向下兼容的问题修正。
扩展格式 部分版本号会在末尾添加日期或希腊字母标识,例如:
```
1.2.3-20251002
```
或
```
1.2.3-alpha.1
```
日期格式通常为“年-月-日”,希腊字母用于标识版本阶段(如`alpha`、`beta`、`RC`、`release`)。
二、版本号规则
主版本号
仅当软件进行不兼容的API修改时递增,例如从1.2.3升级到1.3.0。
次版本号
表示向下兼容的功能性新增,如新增权限控制、自定义视图等。
修订号
用于记录向下兼容的问题修正,通常每次修复一个主要bug。
阶段标识
通过希腊字母标识开发阶段:
- Base: 基础架构阶段,仅包含页面布局,无功能实现; - Alpha
- Beta:功能较完善,但需进一步测试,可对外发布;
- RC(Release Candidate):接近正式版,错误率极低;
- Release:最终交付版本。
三、版本号管理规范
版本号与功能对应 - 重大变更:
主版本号+次版本号(如1.0.0);
- 功能新增:次版本号+修订号(如1.2.1);
- Bug修复:仅修订号(如1.2.2)。
发布说明
每次发布时需记录构建日期、修改内容及修复的Bug编号,便于问题追溯。
避免特殊标识
优先使用标准阶段标识(如`alpha`、`beta`),避免使用预留词汇。
四、示例
一个完整的软件版本号可能为:
```
1.2.3-20251002_beta.1234
```
其中:
`1.2.3`:主版本号.次版本号.修订号;
`-20251002`:日期版本号(年-月-日);
`_beta`:希腊字母标识阶段;
`.1234`:构建编号。
通过规范化的版本号编写,可以清晰地传达软件的更新历程,便于用户理解功能变化与兼容性,同时辅助开发者进行版本控制与维护。