比较两个版本号的大小并说明差在哪一位,正确处理 alpha、beta、rc 等预发布版本;按 npm 的规则解析 ^、~、x、范围和 ||,检查哪些版本满足;还能批量排序版本号,算出下一个版本号。
| 写法 | 含义 | 允许的版本 |
|---|---|---|
| ^1.2.3 | 兼容版本(npm install 的默认写法) | >=1.2.3 <2.0.0 |
| ^0.2.3 | 0.x 时只允许修订号升级 | >=0.2.3 <0.3.0 |
| ~1.2.3 | 只允许修订号升级 | >=1.2.3 <1.3.0 |
| 1.2.x、1.2 | 1.2 系列的任意版本 | >=1.2.0 <1.3.0 |
| 1.2.3 - 2.3 | 闭区间,右侧不完整时按通配 | >=1.2.3 <2.4.0 |
| >=1.0 <2 || 3.x | 空格表示“并且”,|| 表示“或者” | 两段任一满足即可 |
| *、latest | 任意版本(不推荐) | 所有正式版本 |
Composer(PHP)和 Cargo(Rust)的 ^ ~ 规则与 npm 基本相同;Python 的 ~=1.4.2 相当于 >=1.4.2 <1.5,与 npm 的 ~ 接近。编辑 package.json 可以用 package.json 生成器,各包管理器的命令见 npm、pnpm、yarn、bun 命令对照表。
在“比较”中输入两个版本号,查看大小关系和原因;在“范围匹配”中填写 package.json 中的版本范围和要检查的版本列表;在“排序”中粘贴一组版本号;在“下一个版本”中输入当前版本,查看各种升级方式的结果和 npm 命令。
1.10.0 更大,版本号每一位按数字比较,不是按字符串。
^1.2.3 允许升级到 2.0.0 以下的任何版本,~1.2.3 只允许升级到 1.3.0 以下。
1.0.0 更大,带预发布标识的版本小于对应的正式版本。
主版本为 0 时任何次版本变化都可能不兼容,npm 只允许升级修订号。
按 SemVer 2.0.0 和 npm(node-semver)的规则处理;非标准的版本号(如 1.2、10.0.19045.1)在比较中按通用规则逐段比较,在范围匹配和排序中会被忽略。
所有计算在浏览器本地完成,不会上传。
预发布版本没有匹配时,是因为 npm 默认只在范围中写了同一版本号的预发布时才匹配,可以勾选“预发布版本也参与匹配”。
npm、pnpm、yarn、bun 命令对照表 · package.json 生成器 · JSON 格式化校验 · Base64 编码解码 · 全部开发工具