语义化版本规范速查表

语义化版本是软件版本管理的标准,整理版本格式和范围语法,快速理解依赖版本约束。

参考手册·共 15 条命令·最后更新 2026-07-19
返回 参考手册

版本格式 5

MAJOR.MINOR.PATCH
主版本.次版本.修订号
1.2.3
示例:主版本 1,次版本 2,修订号 3
MAJOR:不兼容的 API 变更
破坏性更新时递增
MINOR:向下兼容的功能新增
新增功能时递增
PATCH:向下兼容的问题修复
修复 bug 时递增

预发布版本 4

1.0.0-alpha.1
内部测试版
1.0.0-beta.1
公开测试版
1.0.0-rc.1
候选发布版
alpha < beta < rc < 正式版
预发布版本优先级

npm 版本范围 6

^1.2.3
允许 1.x.x,不允许 2.0.0
~1.2.3
允许 1.2.x,不允许 1.3.0
>=1.2.3
大于等于指定版本
1.2.3 - 2.3.4
版本范围
*
任意版本
latest
最新稳定版

💡 提示

  • ^1.2.3 等价于 >=1.2.3 <2.0.0,是 npm install 的默认行为。
  • ~1.2.3 等价于 >=1.2.3 <1.3.0,只允许补丁版本更新。
  • package-lock.json 锁定精确版本,避免 ^ 和 ~ 带来的不确定性。
  • 破坏性变更必须递增主版本号,即使只是小改动。