如何发布npm包

Posted 2022-12-11 刘翾

文章目录

• 1. 注册账号
• 2. 准备包内文件
• 3. 发布包
• 4. 更新包
• 5. 补充：包版本语法规则及安装时前缀~，^含义
• • 5.1. X.Y.Z - A.B.C 连字符范围
  • 5.2. ~X.Y.Z 波浪线范围
  • 5.3. ^X.Y.Z 脱字符范围

1. 注册账号

前往npm官网注册账号 https://www.npmjs.com/

2. 准备包内文件

新建一个文件夹，终端进入该路径, 输入命令初始化

npm init

根据个人意愿填写完信息之后就可以开始撸代码了，记得要有一个入口文件。

3. 发布包

如果是第一次使用该主机发npm包，则输入命令

npm adduser

否则，输入命令

npm login

---

接下来就可以发布npm包了，输入命令

npm publish

如果提示

npm ERR publish 403

You do not have permission to publish 'npm-test'

说明没有权限发这个包，可以尝试在package.json中改变下包名来解决下这个问题

4. 更新包

和发布包一样的命令

npm publish

记得版本号改一下

5. 补充：包版本语法规则及安装时前缀~，^含义

一个标准的版本号必须是X.Y.Z的形式，X是主版本，Y是副版本，Z是补丁版本。.

• X: 代表发生了不兼容的API改变

• Y: 代表向后兼容的功能性变化

• Z: 代表向后兼容bug fixes

5.1. X.Y.Z - A.B.C 连字符范围

例子1：1.2.3 - 2.3.4 等价于 >=1.2.3 <=2.3.4
例子2：1.2.3 - 2 等价于 >=1.2.3 < 3.0.0

5.2. ~X.Y.Z 波浪线范围

~会匹配最近的小版本依赖包

例子1： ~1.2.3 等价于 >=1.2.3 <1.(2+1).0 等价于="">=1.2.3 <1.3.0
例子2：~1.2 等价于 >=1.2.0 <1.(2+1).0 等价于="">=1.2.0 <1.3.0 (Same as 1.2.x)
例子3：~1 等价于 >=1.0.0 <(1+1).0.0 等价于 >=1.0.0 <2.0.0 (Same as 1.x)

5.3. ^X.Y.Z 脱字符范围

^会匹配最新的大版本依赖包，注意：脱字符范围之后指定从左面起第一个非零位置的范围。

例子1： ^1.2.3 等价于 >=1.2.3 <2.0.0
例子2： ^0.2.3 等价于 >=0.2.3 <0.3.0

当然如果最后一位省略了或为通配符x,X,*,则指定前一位字符的范围，如

例子1：^1.2.x 等价于 >=1.2.0 <2.0.0
例子2：^0.0.x 等价于 >=0.0.0 <0.1.0

---

参考链接：

1. https://segmentfault.com/a/1190000013940567
2. https://segmentfault.com/q/1010000006124708/a-1020000006124855