命令
npm help version
npm version -h # 简版说明
1
2
2
1. 标准版本号:
MAJOR.MINOR.PATCH
2. 先行版本号(Pre-release Version)
先行版本号是作为正式版之前的版本,格式为在修订版本号(PATCH)后追加 -,再加上一连串以 . 分割的标识符,如:
npm i vue@3.0.0-alpha.0
1
安装和发布先行版:
npm i vuepress-plugin-auto-sidebar
# 等价于
npm i vuepress-plugin-auto-sidebar@latest
# 当发布先行版本,例如
npm publish --tag=next
npm i vuepress-plugin-auto-sidebar@next
1
2
3
4
5
6
2
3
4
5
6
版本规范
关于指定版本范围的详细信息参见 semver (opens new window),常见:
1. x
| version | range |
|---|---|
| * | any |
| 1.x | >= 1.0.0 < 2.0.0 |
| 1.2.x | >= 1.2.0 < 1.3.0 |
| 1 | 1.x |
| 1.2 | 1.2.x |
2. ~
当涉及先行版本号时只匹配对应 version。
| version | range |
|---|---|
| ~1 | 1.x |
| ~1.2 | 1.2.x |
| ~1.2.3 | >= 1.2.3 < 1.3.0 |
| ~1.2.3-beta.0 | >= 1.2.3-beta.0 < 1.3.0 |
3. ^(默认)
不允许修改左侧非 0 元素。
| version | range |
|---|---|
| ^0 | 0.x |
| ^0.x | 0.x |
| ^0.0 | 0.0.x |
| ^0.0.x | 0.0.x |
| ^0.0.1 | >= 0.0.1 < 0.0.2 |
| ^0.1.2 | >= 0.1.2 < 0.2.0 |
| ^1.2.3 | >= 1.2.3 < 2.0.0 |
| ^1.2.3-beta.2 | >= 1.2.3-beta.2 < 2.0.0 |
版本升级
npm version [参数]
1
| 参数 | 选项 | 说明 |
|---|---|---|
| new version | 符合版本规范即可,当低于之前版本时会导致 npm publish 失败。 | |
| patch | 修订号,常用于修复错误。 | |
| minor | 次版本号,常用于新增功能,会导致 patch 置为 0。 | |
| major | 主版本号,常用于不兼容的 API 修改,会导致 patch、minor 置为 0。 | |
| prepatch/preminor/premajor/prerelease | --preid=<prerelease-id> | 常见先行版本号名称有 alpha、beta。 |
1. 配合 git
其更为好用的功能是配合 git 进行使用,更新 package.json 的同时打上 tag:
npm version patch -m "chore: 发布 tag %s"
1