软件版本号命名规范

原创于 2025-06-25 07:52:11 发布 · 1.1k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#c++ #软件版本

RT-Thread 专栏收录该内容

26 篇文章

订阅专栏

软件版本号命名规范

一、软件版本号命名规范
- 版本号的基本组成
二、语义化版本（SemVer）
- 1、预发布标签
- 2、构建元数据
二、其他流行的版本控制方案
三、版本号的技术实现
四、常见问题解决方案

一、软件版本号命名规范

版本号是软件发布过程中至关重要的标识符，它不仅帮助开发团队管理代码变更，还向用户传达了更新的重要程度和兼容性信息。本文将全面解析软件版本号的命名规范、技术实践和行业惯例。
软件版本号命名通常遵循一定的行业惯例，以确保版本管理的清晰性和一致性。以下是常见的命名规范：

版本号的基本组成

现代软件版本号通常由以下几部分组成：

主版本号.次版本号.修订号[-预发布标签][+构建元数据]

示例：

2.5.0 - 稳定版
3.0.0-beta.1 - 第一个Beta测试版
1.4.7+20230815 - 带构建日期的版本

二、语义化版本（SemVer）

语义化版本（Semantic Versioning）是目前最广泛采用的版本命名规范，其格式为 MAJOR.MINOR.PATCH：

MAJOR：主版本号，表示不兼容的API变更或重大更新。
MINOR：次版本号，表示向后兼容的功能新增或改进。
PATCH：修订号，表示向后兼容的问题修复。

示例：

1.0.0  // 初始发布
1.1.0  // 新增功能
1.1.1  // bug修复
2.0.0  // 重大变更，不兼容旧版本

1、预发布标签

可选的预发布标识符，用连字符分隔：

alpha/a - 内部测试版
beta/b - 公开测试版
rc - 发布候选版

示例：

1.0.0-alpha.1
2.3.0-beta.2
3.0.0-rc.1

2、构建元数据

用加号分隔的额外信息：

+build.20230815
+sha.7c11d4f

二、其他流行的版本控制方案

1、日期版本

某些项目使用发布日期作为版本号，格式通常为 YYYY.MM.DD 或 YYYYMMDD：

示例：

2023.10.01  // 2023年10月1日发布
20231001    // 简化格式

2、内部版本号

企业或大型项目可能使用内部版本号，通常为递增的数字或字母组合：

示例：

Build 1234
Rev A

3、预发布版本

预发布版本（如alpha、beta、RC）通常在主版本号后附加标识：

示例：

1.0.0-alpha // Alpha测试版
1.0.0-beta // Beta测试版
1.0.0-rc1 // Release Candidate 1

4、微软四组件版本

主版本.次版本.构建号.修订号
例如5.1.2600.5512 (Windows XP SP3)

5、Ubuntu版本号

YY.MM + 可选字母

22.04 (2022年4月发布)
22.04.1 (第一个更新)

6、其他常见规范

简化版本：仅使用 MAJOR.MINOR（如 2.1），忽略PATCH号。
多数字版本：如 MAJOR.MINOR.PATCH.BUILD（1.2.3.4），用于更细粒度的管理。
字母后缀：如 1.0a（Alpha）、1.0b（Beta）。

选择版本命名规范时需根据项目需求、团队习惯和行业标准决定，语义化版本因其明确性成为推荐选择。

三、版本号的技术实现

1、在代码中定义版本号

C/C++

#define VERSION_MAJOR 2
#define VERSION_MINOR 5
#define VERSION_PATCH 0
#define VERSION_STRING "2.5.0"

Python示例（__init__py）：

__version__ = "1.3.7"
__version_info__ = (1, 3, 7)

2、自动化版本管理工具

npm：npm version [major|minor|patch]

Git：结合标签(tag)管理版本

git tag -a v1.2.3 -m "Release version 1.2.3"
git push origin v1.2.3

3、CI/CD中的版本管理

GitHub Actions示例：

jobs:
  build:
    runs-on:ubuntu-latest
    steps:
    -uses:actions/checkout@v2
    -name:Getversion
      id:version
      uses:martinbeentjes/npm-get-version-action@v1
    -name:Buildwithversion
      run: |
        echo "Building version ${{ steps.version.outputs.current-version }}"