规范升级NPM包

雪狐毛领家

规范升级 NPM 包 159 规范升级 NPM 包前言在日常工作中，当组件跨项目使用时，我们往往会选择把组件抽成 npm 包。那么在 npm 开发以及发布的过程中有什么需要注意的事项吗？本文将从我自己的角度，来为大家介绍一下我认为的一些需要大家注意的点。版本号规则从日常的开发中我们可以看到，npm 包的版本号的格式都是 X.Y.Z。那么大家发布的 npm 包为什么都在遵循这个格式呢？这个格式其实是由 Gravatars 创办者兼 GitHub 共同创办者 [Tom Preston-Werner] http://tom.preston-werner.com/ 所建立。由 GitHub 起草的统一的版本号表示规则，称为 Semantic Versioning (语义化版本表示)。这些规范具体包含的内容大家可以参考[语义化版本 2.0.0]  https://semver.org/lang/zh-CN/ 本文只针对我们开发中容易忽略的地方做一些详述。X 代表主版本号，也叫做大版本号升级大版本时意味着这个包可能做了颠覆性的改动，和低版本的包已经无法兼容。每当主版本号递增时，次版本号和修订号必须归零。Y 代表次版本号，也叫做小版本号当做了向下兼容的功能性新增时，升级小版本号。每当次版本号递增时，修订号必须归零。Z 代表修订号当做了向下兼容的问题修正（bugfix）时， 升级修订号。常见版本格式/引用方式版本引用方式版本号匹配版本解释直接使用版本号2.3.12.3.1只可以匹配 2.3.1 这个版本，如果是比较重要的项目，建议用这种方式固定版本。^:不能修改版本号最左侧非零数字^2.3.1>= 2.3.1 & = 0.3.1 & = 0.01 & = 2.3.1 & = 2.0.0 & = 2.3.0 & = 2.0.0 &  | major | minor | patch | premajor | preminor | prepatch | prerelease | from-git]// newversion：指定更新的版本号// major：大版本并且不向下兼容时，使用 major// minor：有新功能且向下兼容时，使用 minor// patch：修复一些问题、优化等，使用 patch// 以 A：2.3.1 为例npm version premajor // 版本号会成为 3.0.0-0，即 3.0.0 的预发版本npm version preminor // 版本号为成为 2.4.0-0，即 2.4.0 的预发版本npm version prepatch // 版本号成为 2.3.2-0，即 2.3.2 的预发版本/*** 版本号会成为 2.3.2-0。* 执行此命令时，如果没有预发布版本号，则增加 Z，增加预发布号为 0* 如果有预发步号，增加预发步号*/npm version prerelease根据上边的 API 可以看到我们能通过 npm version 2.3.2-beta.1 将 A 的版本升为 2.3.2-beta.1 的形式，除此之外，在 npm 6.4.0 之后，我们也可以使用 --preid 参数来添加前缀：npm version prerelease --preid=beta此种方式需要注意，必须要 commit 本地的修改之后才可以执行。npm version 修改版本号，会默认执行 git add -> git commit -> git tag 操作，此时的版本号看起来有 beta，如下：但是这个 beta 是 git 仓库的 tag，并不是 npm 的 tag。如果不想默认给 git 添加 tag 的话，可以使用以下命令：npm --no-git-tag-version version xxx那么 npm version 执行时具体发生了什么呢？简要流程图如下执行完 npm version 2.3.2-beta.1 之后，如果直接使用 npm publish 来发布的话，发布出来的包的 tag 是 latest，但是我们其实是想发布一个测试包。如果其他人 npm i 下载时就会下载 version 为 2.3.2-beta.1 的包。只有使用 npm publish --tag XXX 才是给 npm 包上打了 tag 标签。执行以下命令就可以生成一个 tag 为 beta 的包：npm run build // 打包npm publish --tag beta // 发布 beta 包如果不小心直接使用 npm publish 发错了也没有关系，可以使用以下命令来添加 tag：npm dist-tag add  @2.3.2-beta.1 当需要删除多余的 tag 时：npm dist-tag rm   给大家提供一条指令完成 beta 版本的发布："scripts": {    "publish:beta": npm version prerelease --preid=beta & npm run build & npm publish --tag=beta"  },代码开发完毕，提交之后，只需要 npm run publish:beta 就可以发布一个测试版本啦以上就是我本次分享的所有内容啦，如果有不足的地方，还望指正。参考文献语义化版本 2.0.0 (https://semver.org/lang/zh-CN/spec/v2.0.0.html)前端工程化（5）：你所需要的 npm 知识储备都在这了(https://juejin.cn/post/6844903870578032647)npm version (https://docs.npmjs.com/cli/v6/commands/npm-version)看「前端团队」，