开发辅助

SemVer 版本范围测试器 — 校验 ^ 与 ~ 范围

把 npm 版本范围展开为具体比较符,直观查看哪些版本满足该范围,并正确处理预发布版本。

免费使用 无需注册 浏览器本地运行

工具操作区

展开后的比较符
>=1.2.0 <2.0.0
1.1.0 不满足
1.2.0 满足
1.2.9 满足
1.9.9 满足
2.0.0 不满足
2.0.0-beta.1 不满足
满足条件的最高版本: 1.9.9

范围展开与比较全部在浏览器内完成,不会访问任何软件源。

版本范围到底允许哪些版本

依赖范围本质上是一组比较符的简写。脱字符允许不改变最左侧非零部分的变更,因此 ^1.2.3 允许低于 2.0.0 的所有版本,而 ^0.2.3 只允许低于 0.3.0,^0.0.3 则不允许高于 0.0.3。波浪号在指定次版本号时允许补丁级变更。多个范围用空格表示“与”、用 || 表示“或”,连字符表示闭区间。本工具会展开这些简写,并按 SemVer 2.0.0 优先级规则评估真实版本,其中包括“预发布版本排在对应正式版之前”这条规则。

如何测试版本范围

  1. 1按 package.json 中的原样输入范围,或直接选用预设简写。
  2. 2查看展开后的比较符,了解该简写实际产生的上下界。
  3. 3逐行列出你关心的版本,例如软件源实际发布的版本列表。
  4. 4查看每一行结果,确认哪些版本满足该范围、哪些不满足。
  5. 5如果你确实需要安装 beta 或候选版本,可开启“包含预发布版本”。

版本范围容易引起困惑的场景

理解 0.x 包上的脱字符

确认 ^0.2.3 不会升级到 0.3.0,这是 npm 版本范围中最容易被误解的一条规则。

预测安装会解析到哪个版本

粘贴已发布的版本列表,查看全新安装会选中其中哪一个。

解释意外升级

在归咎于锁文件之前,先确认该范围是否真的允许了那个导致构建失败的版本。

判断 beta 是否会被选中

确认除非范围指明了完全相同的版本三元组或你主动开启选项,否则预发布版本不会被纳入。

常见问题

为什么 ^0.2.3 和 ^1.2.3 行为不同?

脱字符允许不改变最左侧非零部分的变更。对 1.2.3 来说该部分是主版本号,因此允许低于 2.0.0 的版本;对 0.2.3 是次版本号,因此上界是 0.3.0;对 0.0.3 是补丁号,因此只允许该补丁版本。这是把 1.0 之前的次版本号视为破坏性变更的惯例。

为什么 2.0.0-beta.1 不满足 ^2.0.0?

有两个原因叠加。预发布版本排在对应正式版之前,因此 2.0.0-beta.1 并不满足“大于等于 2.0.0”。此外,除非某个比较符指明了相同的主、次、补丁三元组,npm 会把预发布版本排除在范围之外,以避免 beta 意外进入普通安装。

构建元数据会被考虑吗?

不会。SemVer 规定加号之后的构建元数据不参与优先级比较,因此 1.0.0+a 与 1.0.0+b 视为相等。工具会解析并显示它,但它不影响版本是否满足范围。

会访问 npm 软件源吗?

不会。版本列表由你自己提供,所有比较都在本地完成,因此可离线使用,也不会泄露你正在查看哪些包。