如何发布一个NPM包

如何发布一个NPM包

版权申明:本文为原创文章,转载请注明原文出处

原文链接:https://pangwu86.com/posts/2093845957/

起因是引用了一个 npm 包,发现 bug 后进行了修改并提交了 pull request。等了 20 多天那边一直不上线合并,只能自己把 fork 下来的库单独发布一下了。

准备包内容

新建一个库


创建目录,然后使用命令 npm init 进行初始化,按照提示一路填写并回车即可。

fork 别人的库


把别人的库 fork 后下载到本地,然后修改 pakcage.json 中库名,用户名等个人信息即可。

注册 NPM 账号,然后发布


  1. npm官网 注册账号。
  2. 在命令行下执行 npm login,使用刚才注册的账户信息进行登录。
  3. 在命令行下进入项目根目录,执行 npm public,发布成功后会收到一份 npm 发送的邮件。
  4. npm官网 搜索包名应该就能看到了。

发布成功!

错误处理

Error 403:Forbidden


说明你起的包名在 npm 的公开库上已经存在了,所以要么改名,要么给包名加一下前缀,比如把 mylib 改成 @xx/mylib

Error 402:Payment Required


如果包名称带有 @xx 前缀,默认被当做私有库进行发布。而私有库是需要额外收费的,所以在发布这种库时需要指定其为公开库,不过仅仅是第一次发布需要,后续更新再发布可以不用加参数了。

1
2
# 第一次发布带有 @xx 前缀的库
npm publish --access public

第一次发布需要带参数 --access public

注意事项


如果是 fork 别人的库进行修改的,特别需要注意下原本库使用的开源许可是否允许这种二创的行为。

关于各种开源许可证的差异,可以参考以下几篇文章,都讲的不错。

懒得看文章的,直接看下面的图吧。

一图胜千言,按需选择即可

作者

胖五

发布于

2021-06-08

更新于

2021-06-09

许可协议


评论