NPM package 版本管理

说到npm package 相信很多人都遇到过修改 package.json 里面version 字段的经历，然而修改的时候相信很多人都是手动修改的，如何能比较优雅的修改呢？

版本号组成

node package版本号由四部分组成：major.minor.patch[-prerelease]，比如：1.0.2-beta.1，其中prerelease可选。

在Node.js中，语义化版本（Semantic Versioning）是一种用于管理代码库版本的标准。它使用三个数字（major.minor.patch）来表示版本号，每个数字都有特定的含义。

•

主版本号（Major）：表示不兼容的 API 更改，即当主版本号增加时，代码库中的公共 API 可能会发生重大更改，可能与之前的版本不兼容。
•

次版本号（Minor）：表示向下兼容的功能添加，即当次版本号增加时，代码库中添加了新的功能，但这些新功能不会破坏与之前的版本的兼容性。
•

修订号（Patch）：表示向下兼容的错误修复，即当补丁版本号增加时，代码库中的错误得到了修复，但这些修复不会破坏与之前的版本的兼容性。
•

先行版本号 (prerelease)：带有该版本号的包通常表示在测试阶段，尚未稳定，通常不建议用户安装。

先行版本号的定义：

先行版本号可以被标注在修订版之后，先加上一个连接号再加上一连串以句点分隔的标识符来修饰。标识符必须由 ASCII 字母数字和连接号 [0-9A-Za-z-] 组成，且禁止留白。数字型的标识符禁止在前方补零。先行版的优先级低于相关联的标准版本。被标上先行版本号则表示这个版本并非稳定而且可能无法满足预期的兼容性需求。范例：1.0.0-alpha、1.0.0-alpha.1、1.0.0-0.3.7、1.0.0-x.7.z.92。

npm version [<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease | from-git]

npm 提供了自动升级版本号的工具：npm version，该工具会自动修改package.json内的版本号并且会自动 git commit，因此使用该工具时请保持git status是clear的。

NPM包的先行版本号是指在正式发布之前，开发者可以通过添加特定标识来标记软件包的预发布版本。在版本号中，先行版本号位于主版本号、次版本号和修订号之后，并以连字符或者小数点分隔。先行版本号的目的是让开发者和用户在软件包发布前进行测试和评估，以便及时发现和修复可能存在的问题。

先行版本号的标识可以是任意的，但常见的标识包括：

alpha: 表示软件包的初步开发阶段，通常只有基本功能并且可能存在较多的缺陷。
beta: 表示软件包已经经过一些测试，并且功能比较完整，但仍然可能存在一些缺陷。
rc（release candidate）: 表示软件包已经相对稳定，并且已经具备了所有功能，但仍然需要最后的测试和确认。
pre: 表示除了上述常见的标识之外的其他先行版本号。

使用先行版本号，开发者可以让用户更早地尝试他们的软件包，并从用户的反馈中获得宝贵的改进意见。同时，用户也能够提前了解即将发布的软件包的功能和特性，以便做出合适的决策。

下面是一些具体操作

# 给当前包的版本设置为 1.0.0
npm version 1.0.0

# 运行下面命令将由1.0.0变为1.0.1 修订号升级：v1.0.1
npm version patch

# 运行下面命令将由1.0.0变为1.1.0  次版本号升级：v1.1.0
npm version minor

# 运行下面命令将由1.0.0变为2.0.0  主版本号升级：v2.0.0
npm version major

# 运行下面命令将由1.0.0变为 2.0.0-rc.0
npm version premajor --preid=rc

# 运行下面命令将由1.0.0变为 1.1.0-beta.0
npm version preminor --preid=beta

# 运行下面命令将由1.0.0变为 1.0.1-alpha.0
npm version prepatch --preid=alpha

# 运行下面命令将由1.0.0变为 1.0.1-0  如果是1.0.1-alpha.0将变为1.0.1-alpha.1
npm version prerelease

# 再次运行会由 1.0.1-0变为 1.0.1-1  如果是1.0.1-alpha.1将变为1.0.1-alpha.2
npm version prerelease

# 运行下面命令将由1.0.1-1变为 2.0.0   7.0.0-beta.0=>7.0.0
npm version major

# 运行下面命令将由 1.1.0-beta.0 变为 1.1.0
npm version minor

# 运行下面命令将由 1.0.1-alpha.变为 to 1.0.1
npm version patch

npm install ，会安装哪个版本的**package** 最新版本？

npm install ，会安装哪个版本的package 答案是latest指向的version。

npm install vue ===  npm install vue@latest

当我们修改一个npm包的时候不想让线上用户收到影响可以发布一个beta版本

npm publish --tag beta

这样用户执行npm i的时候是安装不上的需要运行下面的命令

npm install vue@beta

这样可以避免用户执行npm i 后使用beta版本的代码

通过npm dist-tag ls指令可以查看某个package的所有tag

以vue为例：

> npm dist-tag ls vue
alpha: 3.3.0-alpha.13
beta: 3.3.0-beta.5
csp: 1.0.28-csp
latest: 3.3.4
legacy: 2.6.14
next: 3.2.36
preview: 3.0.3
v2-alpha: 2.7.0-alpha.12
v2-beta: 2.7.0-beta.8
v2-latest: 2.7.14

这也解释了为什么vue刚出来的时候没有成为默认版本的时候需要运行 npm i vue@next next 为标签名字和beta类似。说明到时发布的时候使用的是命令