12. npm version方法总结

npm version 是官方推荐的方式,它会自动更新 package.json 并(可选)创建 Git Tag。

1.基本语法

js 复制代码
npm version <new_version | major | minor | patch | premajor | preminor | prepatch | prerelease>
1.常用选项
命令 作用 示例(当前版本 1.2.3 → 新版本)
npm version major 主版本号 +1,次版本和补丁归零 2.0.0
npm version minor 次版本号 +1,补丁归零 1.3.0
npm version patch 补丁版本号 +1 1.2.4
npm version premajor 预发布主版本(如 2.0.0-alpha.0 2.0.0-0
npm version prerelease 预发布版本号 +1(如 1.2.4-beta.1 1.2.4-0
npm version 1.5.0 直接指定版本号 1.5.0
附加参数
  • --no-git-tag:不创建 Git Tag(默认会创建)。
  • -m "版本描述":自定义 Git Tag 消息(如 npm version patch -m "修复了XX问题")。
  • --allow-same-version:允许版本号不变(通常用于触发版本钩子)。

3. 使用 npm pkg 命令(npm v7+)

通过命令行直接修改 package.json

bash

bash 复制代码
npm pkg set version="1.2.4"

4. 预发布版本管理

如果需要发布 Alpha/Beta/RC 版本:

bash 复制代码
# 当前版本 1.2.3
npm version prerelease --preid=alpha  # → 1.2.4-alpha.0
npm version prerelease               # → 1.2.4-alpha.1
npm version prepatch --preid=beta    # → 1.3.0-beta.0

5. 版本号规则(SemVer 语义化版本)

npm 遵循 SemVer 2.0 规范,格式为:
主版本.次版本.补丁版本-预发布标签+构建元数据

  • 主版本(Major) :不兼容的 API 变更。
  • 次版本(Minor) :向后兼容的功能新增。
  • 补丁版本(Patch) :向后兼容的问题修复。
  • 预发布标签(Prerelease) :如 -alpha.0-beta.1
  • 构建元数据(Build Metadata) :如 +20240501(通常忽略)。

6. 强制修改版本(不推荐)

如果版本号格式错误或需要强制覆盖:

bash 复制代码
npm --no-git-tag version 1.2.3 --allow-same-version

7.示例工作流

bash 复制代码
# 1. 更新补丁版本并提交 Git
npm version patch -m "修复登录页样式问题"

# 2. 推送代码和 Tag
git push && git push --tags

# 3. 发布到 npm
npm publish

如果需要更复杂的版本管理,可以结合工具:

  • standard-version:自动化版本号和 CHANGELOG 生成。
  • lerna:多包管理项目的版本控制。
相关推荐
augenstern4161 小时前
HTML面试题
前端·html
张可1 小时前
一个KMP/CMP项目的组织结构和集成方式
android·前端·kotlin
G等你下课2 小时前
React 路由懒加载入门:提升首屏性能的第一步
前端·react.js·前端框架
谢尔登3 小时前
【React Native】ScrollView 和 FlatList 组件
javascript·react native·react.js
蓝婷儿3 小时前
每天一个前端小知识 Day 27 - WebGL / WebGPU 数据可视化引擎设计与实践
前端·信息可视化·webgl
然我3 小时前
面试官:如何判断元素是否出现过?我:三种哈希方法任你选
前端·javascript·算法
OpenTiny社区3 小时前
告别代码焦虑,单元测试让你代码自信力一路飙升!
前端·github
kk_stoper3 小时前
如何通过API查询实时能源期货价格
java·开发语言·javascript·数据结构·python·能源
pe7er3 小时前
HTTPS:本地开发绕不开的设置指南
前端
晨枫阳4 小时前
前端VUE项目-day1
前端·javascript·vue.js