常见问题
Q: 怎样才算合法的 semver 版本?
合法版本符合 semver 第 2 条:MAJOR.MINOR.PATCH,- 后面可选预发布标识,+ 后面可选构建元数据。1.2.3、1.2.3-beta.1 和 v1.2.3 合法。1.2、01.2.3 以及 ^1.2.3 这类范围运算符都不是单个版本。字符串合法时,校验器会列出解析出的每一部分。
Q: 如何比较两个版本?
在「比较版本」中填入两个版本。优先级由 semver 第 11 条 规定:先比主版本,再比次版本、补丁,最后比预发布号。正式版高于对应的预发布版,因此 1.0.0-beta.1 小于 1.0.0。标识符按数值而不是字符串比较:1.10.0 大于 1.2.0。构建元数据不改变顺序。
Q: 为什么 1.2.4-beta.1 不满足 ^1.2.3?
npm 范围默认不包含预发布版本,除非比较符本身带预发布号,或你主动打开开关。关闭「包含预发布版本」时,1.2.4-beta.1 不满足 ^1.2.3(即 >=1.2.3 <2.0.0-0)。打开开关后,同一对就会匹配。这与安装依赖时的 npm semver 行为一致。
Q: ^ 和 ~ 的区别是什么?
^(caret)允许在不修改最左边非零版本号的前提下进行更新。例如 ^1.2.3 匹配 >=1.2.3 <2.0.0,允许 minor 和 patch 级别的更新。~(tilde)则更保守,仅允许 patch 级别的更新。例如 ~1.2.3 匹配 >=1.2.3 <1.3.0,只接受补丁版本变更。简单来说,^ 信任库作者遵循语义化版本规范(新功能向后兼容),~ 则只接受 bug 修复。
Q: 为什么 npm 默认使用 ^ 而不是精确版本?
npm 默认使用 ^ 是为了在稳定性和灵活性之间取得平衡。精确版本锁定虽然最安全,但会导致依赖树中出现大量重复包,增大 node_modules 体积,也无法自动获取安全补丁。而 ^ 允许自动接收向后兼容的更新,包括 bug 修复和新功能,同时通过 package-lock.json 确保团队成员之间的版本一致性。这种策略假设库作者遵循 semver 规范,不会在 minor 版本中引入破坏性变更。
Q: 0.x.x 版本的 ^ 和 ~ 有特殊行为吗?
是的,这是 semver 中一个容易踩坑的地方。在 0.x.x 版本中,^ 的行为会发生变化:^0.2.3 匹配 >=0.2.3 <0.3.0,相当于 ~0.2.3,因为 0.x 阶段被视为不稳定版本,任何 minor 变更都可能包含破坏性修改。更极端的是 ^0.0.3 只匹配 0.0.3 本身。这意味着在使用 0.x 版本的库时,^ 并不像 1.x 以上那样宽松,需要特别留意。
Q: 如何锁定依赖版本?
有多种方式可以锁定版本。最简单的方法是在 package.json 中直接写精确版本号,如 "lodash": "4.17.21",不加任何前缀。也可以使用 npm install --save-exact 或在 .npmrc 中设置 save-exact=true 来默认使用精确版本。此外,package-lock.json(npm)或 pnpm-lock.yaml(pnpm)会记录实际安装的精确版本,确保 CI/CD 和团队成员使用完全相同的依赖版本。建议将 lock 文件提交到版本控制中。
Q: prerelease 版本(如 1.0.0-beta.1)怎么比较?
prerelease 版本的优先级低于对应的正式版本。例如 1.0.0-alpha.1 < 1.0.0-beta.1 < 1.0.0-rc.1 < 1.0.0。prerelease 标识符按照从左到右逐段比较:纯数字段按数值大小比较,字符串段按字典序比较,数字段的优先级低于字符串段。需要注意的是,在范围表达式中,^1.0.0 和 ~1.0.0 默认不会匹配到 1.1.0-beta.1 这样的 prerelease 版本,只有与范围中指定的 major.minor.patch 相同的 prerelease 才会被包含。