npm version
管理包版本号，自动更新 package.json 并创建 git tag
语法
npm version <newversion> [--no-git-tag-version]
参数
| 参数 | 说明 | 示例 | 级别 |
|---|---|---|---|
patch |
补丁版本 +1（1.0.0 → 1.0.1） | npm version patch |
常用 |
minor |
次版本 +1（1.0.0 → 1.1.0） | npm version minor |
常用 |
major |
主版本 +1（1.0.0 → 2.0.0） | npm version major |
常用 |
prerelease |
预发布版本 | npm version prerelease --preid=beta |
进阶 |
--no-git-tag-version |
不创建 git commit 和 tag | npm version patch --no-git-tag-version |
进阶 |
示例
发布补丁修复
npm version patch npm publish
修复 bug 后升补丁版本
发布新功能
npm version minor npm publish
新增功能但向后兼容
发布 beta 版
npm version prerelease --preid=beta
1.0.0 → 1.0.1-beta.0
查看当前版本
npm version
显示 npm、node 和项目版本
常见错误
Git working directory not clean
有未提交的修改，先 git commit 或加 --force
Version not changed
指定的版本和当前相同，检查版本号
技巧
- 遵循语义化版本：breaking change 升 major，新功能升 minor，bug 修复升 patch
- npm version 会自动创建 git tag，方便追溯
- 在 CI 中可以用 npm version --no-git-tag-version 避免 git 操作