Skip to content

Semantic Versioning

一句话解释

语义化版本(SemVer)以 MAJOR.MINOR.PATCH 编号发布,每段表示变更类型。

用大白话说

语义化版本(SemVer)是一种版本编号方案:MAJOR.MINOR.PATCH。给定版本 2.4.1:MAJOR(2)在不兼容 API 变更时变,MINOR(4)在向后兼容新功能时变,PATCH(1)在向后兼容 bug 修复时变。预发布追加 -alpha、-beta、-rc.1;构建元数据追加 +sha。承诺是消费者可安全更新到更高的 PATCH 或 MINOR 而不破坏,并知道更高的 MAJOR 需查阅迁移指南。这使自动依赖更新与范围表达式如 ^1.2.3(任何 ≥1.2.3 的 1.x.x)或 ~1.2.3(任何 ≥1.2.3 的 1.2.x)成为可能。SemVer 与约定式提交天然搭配:feat 提交提升 MINOR,fix 提升 PATCH,BREAKING CHANGE 提升 MAJOR。semantic-release 等工具自动化此过程。SemVer 在 npm、Cargo 及许多包生态中广泛采用。

示例

bash
# Version progression example
1.0.0   # initial release
1.0.1   # bug fix → PATCH bump
1.1.0   # new feature, backward compatible → MINOR bump
2.0.0   # breaking API change → MAJOR bump
2.0.0-alpha.1  # pre-release of 2.0.0
2.0.0+sha.abc  # build metadata

# npm range expressions
^1.2.3  # >=1.2.3 <2.0.0 (any 1.x.x at or above 1.2.3)
~1.2.3  # >=1.2.3 <1.3.0 (any 1.2.x at or above 1.2.3)

MAJOR 破坏 API,MINOR 加兼容功能,PATCH 修 bug。package.json 中 ^ 与 ~ 表达兼容范围。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表