那些被你忽略的npm知识

关于版本号

npm采用了semver规范作为依赖版本管理方案。版本格式一般为：主版本号.次版本号.修订号(x.y.z)

主版本号（major）：一般改动很大，不兼容低版本
次版本号（minor）：兼容同一个大版本的API和用法
修订号（patch）：一般用来修复bug
有的时候在修订号后面可能还会有先行版本号，例如1.0.0-alpha.1，1.0.0-beta.4，2.0.0-rc.1等。常用的先行版本一般为alpha，beta，rc，stable，csp等。

常用版本运算符

^ 运算符：左边第一个非零版本相同

'^1.5.6'  等同于 '>=1.5.6  <2.0.0'
'^0.5.6'  等同于 '>=0.5.6  <0.6.0'
'^0.0.6'  等同于 '>=0.0.6  <0.0.7'

~ 运算符：只含有主版本，主版本相同即可；含有次版本，主版本和次版本都需相同。
```
'~1'  等同于 '>=1.0.0  <2.0.0'
'~0.5.6'  等同于 '>=0.5.6  <0.6.0'
```
x 运算符：匹配任意的数字
```
'1.x'  等同于 '>=1.0.0  <2.0.0'
'1.5.x'  等同于 '>=1.5.0  <1.6.0'
'*'  等同于 '>=0.0.0'
```
我们实际开发中为防止第三方包做的修改对我们有影响，一般我们会固定版本，即安装指定版本。

关于发布npm包

发布
npm publish: 发布npm包
修改版本号
npm version major: 主版本号加 1，其余版本号归 0
npm version minor: 次版本号加 1，修订号归 0
npm version patch: 修订号加 1
npm version 版本号：设置版本号为指定的版本号
npm version prerelease: 先行版本号增加1
npm version prerelease --preid=alpha 假设现在的version是1.3.5，执行完该命令之后就会成为 1.3.6-alpha.0
在git环境中，执行npm version修改完版本号之后，还会默认执行git add->git commit->git tag操作。如果git工作区还有未提交的修改，npm version会执行失败。
修改发版的commit信息
默认的提交信息就是我们的版本号，假如我们需要修改提交信息的话，只需在npm version 命令后加上-m选项即可，%s会被替换成为版本号。
npm version prerelease -m "update %s"
禁用版本提交和标记tag
npm --no-git-tag-version version prerelease

关于npm包的删除

npm unpublish 包名：在npm上删除了指定的包。

关于npm的tag

npm dist-tag 包名: 查看指定包的tag和对应的最新version。
npm publish --tag alpha: 在名为alpha的tag上进行发版。
npm中的tag类似于git中的branch，发布者可以在指定的tag上进行发版，使用者可以选择指定tag来安装，默认的tag是latest。

带有命名空间的包

有些时候需要创建一个公司内部使用的模块，或者某个模块已经有了同名的模块存在，这个时候可以用到带有命名空间的模块，其名称形如 @scope/project。在 npm 上面带有命名空间的模块默认是私有的，是需要付费的，因此为了免费地发布一个带有命名空间的模块，需要在执行 publish 的时候加上 --access=public 选项。同时，在安装域级包时需要按照域级包全名来安装：npm i @scope/project

其他有用的命令

npm whoami: 显示 npm 用户名
npm view 包名: 显示包的详细信息
npm view 包名 versions: 显示包的所有历史版本
npm repo 包名: 打开包的源码仓库页面
npm docs 包名: 打开包的文档地址

参考资料

你所需要的npm知识储备都在这