版本范围到底允许哪些版本
依赖范围本质上是一组比较符的简写。脱字符允许不改变最左侧非零部分的变更,因此 ^1.2.3 允许低于 2.0.0 的所有版本,而 ^0.2.3 只允许低于 0.3.0,^0.0.3 则不允许高于 0.0.3。波浪号在指定次版本号时允许补丁级变更。多个范围用空格表示“与”、用 || 表示“或”,连字符表示闭区间。本工具会展开这些简写,并按 SemVer 2.0.0 优先级规则评估真实版本,其中包括“预发布版本排在对应正式版之前”这条规则。
如何测试版本范围
- 1按 package.json 中的原样输入范围,或直接选用预设简写。
- 2查看展开后的比较符,了解该简写实际产生的上下界。
- 3逐行列出你关心的版本,例如软件源实际发布的版本列表。
- 4查看每一行结果,确认哪些版本满足该范围、哪些不满足。
- 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 软件源吗?
不会。版本列表由你自己提供,所有比较都在本地完成,因此可离线使用,也不会泄露你正在查看哪些包。