发布npm包时遇到的一些坑

原创已于 2022-05-02 17:06:46 修改 · 3.4k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#npm #node.js #前端

于 2022-01-05 21:50:38 首次发布

uni-app 专栏收录该内容

25 篇文章

订阅专栏

本文指导你如何处理npm发布过程中遇到的常见问题，包括邮箱验证未完成、权限不足、登录需求、管理员权限、包名冲突、私有包发布限制等，并提供相应的解决方案和修改建议。

文章目录

1、邮箱未验证
2、没有权限发布
3、需要登录
4、只有管理员才有权限发布
5、包名过于类似
6、无法发布到私有包

以下每个问题都包含报错信息，请善用ctrl + f搜索，下文报错中涉及到包名的都替换为了your-package。

1、邮箱未验证

npm ERR! publish Failed PUT 403
npm ERR! code E403
npm ERR! you must verify your email before publishing a new package: https://www.npmjs.com/email-edit : your-package

这个是注册后没有进行邮箱验证，登录自己邮箱找到对应的邮件确认就好了。注意别选错了，注册 npm 时会发给你两个邮件，注意看到底是哪个。如果验证邮件过期的话登录自己的 npm 主页重新发一个就好了。
请添加图片描述

2、没有权限发布

npm ERR! publish Failed PUT 403
npm ERR! code E403
npm ERR! You do not have permission to publish "your-package". Are you logged in as the correct user? : your-package

你的包和别人的包重名了，npm 里的包不允许重名，所以去 npm 搜一下，改个没人用的名字就可以了

3、需要登录

npm ERR! code ENEEDAUTH
npm ERR! need auth auth required for publishing
npm ERR! need auth You need to authorize this machine using `npm adduser`

后面已经注明了，输入 npm adduser 重新登录就可以了，过程和 npm login 一样，这个问题在你切换了 npm 源之后或登录过期后都有可能发生。

4、只有管理员才有权限发布

npm ERR! publish Failed PUT 403
npm ERR! code E403
npm ERR! [no_perms] Private mode enable, only admin can publish this module [no_perms] Private mode enable, only admin can publish this module: your-package

这个是你的源设置成第三方源的时候才有可能发生，比如设置了淘宝源就可能会导致该问题。只要把源改回默认的就可以了，如下：

npm config set registry http://registry.npmjs.org

5、包名过于类似

npm ERR! publish Failed PUT 403
npm ERR! code E403
npm ERR! Package name too similar to existing packages; try renaming your package to '@hopgoldy/auto-git' and publishing with 'npm publish --access=public' instead : your-package

如果npm上已经有了不少和你的包名类似的包，就会出现这个问题，在package.json中修改你的包名就可以了

6、无法发布到私有包

npm ERR! publish Failed PUT 402
npm ERR! code E402
npm ERR! You must sign up for private packages :

这个当你的包名为@your-name/your-package时才会出现，原因是当包名以@your-name开头时，npm publish会默认发布为私有包，但是 npm 的私有包需要付费，所以需要添加如下参数进行发布:

npm publish --access public