【SemVer语义化版本规范】

语义化版本号规范（SemVer）解析

语义化版本号规范（SemVer）通过 主版本号.次版本号.修订号（MAJOR.MINOR.PATCH）的格式明确版本迭代的含义：

• MAJOR：破坏性变更（不兼容的API修改或重大重构）。
• MINOR：新增功能（向后兼容，不影响现有功能）。
• PATCH：问题修复（向后兼容的缺陷修正）。

示例：v2.3.1 表示主版本为2，新增3次功能，修复1次问题。

版本号控制实践

版本号递增规则

• 初始开发阶段（如 0.1.0）允许快速迭代，MAJOR为0时表示API不稳定。
• 正式发布后（1.0.0 开始）需严格遵循SemVer规则：
  • 修复问题后递增 PATCH（1.0.0 → 1.0.1）。
  • 新增功能后递增 MINOR（1.0.1 → 1.1.0）。
  • 破坏性变更后递增 MAJOR（1.1.0 → 2.0.0）。

预发布版本标记

• 在正式版本前可添加预发布标识符，如 2.0.0-alpha.1 或 2.0.0-beta。

案例分析

案例：Node.js 的版本迭代

• v14.0.0 → v14.1.0：新增非破坏性功能。
• v14.1.0 → v14.1.1：修复安全漏洞。
• v14.1.1 → v15.0.0：引入破坏性变更（如废弃API）。

代码实现示例

Python 版本号解析与比较

from packaging import version

# 版本号解析
v1 = version.parse("2.3.1")
v2 = version.parse("2.4.0-alpha")

# 比较版本
print(v1 < v2)  # True，因为 2.3.1 < 2.4.0
print(v2.is_prerelease)  # True，因为是预发布版本

JavaScript 实现版本号校验

const semver = require('semver');

// 校验有效性
console.log(semver.valid('1.2.3')); // '1.2.3'
console.log(semver.valid('1.x.y')); // null

// 比较版本
console.log(semver.gt('2.3.1', '2.4.0')); // false
console.log(semver.satisfies('1.2.3', '^1.0.0')); // true（兼容主版本1）

Git 标签管理

# 打版本标签
git tag -a v1.2.3 -m "Release version 1.2.3"
git push origin v1.2.3

工具推荐

• npm：内置 semver 库用于Node.js项目版本管理。
• Poetry：Python项目的依赖管理工具，支持SemVer。
• Git Tags：结合CI/CD工具（如GitHub Actions）自动化版本发布。