npm 版本范围测试器
检查列表中的版本是否符合 npm 依赖范围。对比当前范围和拟用范围,看看哪些版本的判定会改变。
如何测试版本范围
- 输入一个 npm 范围,或切换到比较模式并输入两个范围。
- 粘贴版本,每行一个,然后选择是否包含预发布版本。
- 运行测试,查看各版本的判定,然后复制所需列表。
版本如何匹配
一个版本必须满足范围中至少一个分支的全部比较条件。
按 npm 默认规则,即使预发布版本满足比较边界,也可能被排除。
比较计数只针对你提供的版本。新增允许的版本仅匹配拟用范围。
示例
将范围从 ^1.2.3 改为 ~1.4.0 后,输入列表中的 1.4.2 仍然匹配,1.5.0 则不再匹配。
默认情况下,1.x 排除 1.0.0-beta.1。包含预发布版本后,下界改变,该版本便可通过。
范围和列表限制
请使用 npm 范围表达式和完整版本。最多接受 64 条非空记录,参与比较的数字有上限。
结果依据固定版本的 npm 范围规则检查你提供的列表。
本地测试
浏览器在设备上测试粘贴的范围和版本。
npm 版本范围常见问题
参考资料
以下资料定义版本语法和 npm 范围匹配规则。
- semver.org语义化版本 2.0.0定义完整版本、优先级、预发布标识和构建元数据。
- github.comnpm 范围规则 · node-semver 7.8.5说明 npm 的范围语法和预发布规则。此工具使用上述固定版本的解析器。
- node-semver 许可证(ISC)
核对日期:2026 年 11 月 19 日。
