跳到主要内容

Semver 版本校验与比较

校验版本号

检查版本是否合法,并查看主版本、次版本、补丁、预发布号与构建号。

示例

合法
1.2.3-beta.1
主版本
1
次版本
2
补丁
3
预发布
beta.1
构建
exp.sha

比较版本

查看哪个版本更大,以及首个不同的部分。

更小
1.2.0 小于 1.10.0

首个差异:次版本

是否满足范围

测试某个版本是否落在 npm 范围表达式内。

关闭时与 npm 一致:1.2.4-beta.1 不满足 ^1.2.3。

不满足
1.2.4-beta.1 不满足 >=1.2.3 <2.0.0-0

版本范围解析

展开 ^、~、x 等 npm 范围语法。

>=1.2.3 <2.0.0-0

最常见版本号(可点击)

semver

Semantic Version,即语义化版本号。由三部分组成,MAJOR.MINOR.PATCH。

MAJOR发布含 Break Change 的 API 时
MINOR发布新功能 API 时
PATCH修复 Bug 时
^1.2.3>=1.2.3 <2.0.0
~1.2.3>=1.2.3 <1.3.0

Semver

semver,Semantic Versioning 语义化版本的缩写,文档可见 semver.org。本页是 semver 校验器:粘贴版本号查看是否合法,比较两个版本,并测试版本是否满足 npm 范围。优先级遵循 Semantic Versioning 2.0.0。^ 与 ~ 来自 npm semver 的范围语法,并不属于 semver 规范本身。版本号由 [major, minor, patch] 三部分组成,其中

  • major: 当你发了一个含有 Breaking Change 的 API
  • minor: 当你新增了一个向后兼容的功能时
  • patch: 当你修复了一个向后兼容的 Bug 时

对于 ~1.2.3 而言,它的版本号范围是 >=1.2.3 <1.3.0

对于 ^1.2.3 而言,它的版本号范围是 >=1.2.3 <2.0.0

npm package 通过 semver 进行版本管理。当我们下载 lodash 时,如果此时最新版本号为 lodash@4.17.4,则默认在 package.json 中维护的版本号为 lodash@^4.17.4。