npm 发包

Posted 2020-12-28 hongsusu

前几天封装了公用的locaStorage组件，当然封装后需要发布npm官网，于是摸索了一番终于搞定了，总结下来希望对大家有所帮助

npm安装的package一般支持下面几大类：

    本地包

    url远程包

    仓库中的包

   之前有写过如何链接本地和仓库中的包，想了解的可以点这里，下面进入正题介绍npm发布包包到公共的平台上

一  npm包发布

1.注册包仓库账号

为了维护包，NPM必须要使用仓库账号才允许将包发布到仓库中。注册账号的命令是npm adduser。

$ npm adduser
Username:
Password:
Email:

当然注册也可以直接到官网注册结果是一样的

登陆 https://www.npmjs.com 用邮箱注册接收验证邮件验证就完事了
(此处有两封邮件:Welcome to npm和Verify your npm email address )

 如果已经注册账号：

　则我们用npm login 登录即可

　证明是否登录成功：　

    npm who am i

2.发布

$ npm init //生成package.json，如果有就不用了
$ npm publish [floder] //不带参数默认是当前目录

  如果你以后修改了代码，然后想要同步到 npm 上的话请修改 package.json 中的 version 然后再次 publish，更新的版本上传的版本要大于上次

3.权限

　管理包权限：

　　通常，一个包只有一个拥有权限进行发布。如果需要多人进行发布，可以使用npm owner 命令帮助你管理包的所有者：

　　使用这个命令，也可以添加包的拥有者，删除一个包的拥有者：

$  npm owner ls <package name>
$  npm owner add <user> <package name>
$  npm owner rm <user> <package name>

    注：完全符合CommonJS规范的包目录应该包含如下这些文件。

npm包实际是一个存档文件，即一个目录直接打包为.zip或tar.gz格式的文件，安装后解压还原为目录。我们开发npm包模块的时候，就可以按照以下目录结构，进行开发：

　　package.json : 包描述文件。

　　bin: 用于存放可执行二进制文件的目录。

　　lib：用于存放javascript代码的目录。

　　doc：用于存放文档的目录。

　　test: 用于存放单元测试用例的代码。

4.删除发过的npm包

$  npm --force unpublish testxxxxx

   注：删除要用force强制删除。超过24小时就不能删除了。自己把握好时间。(删除npm包 ，很难删除，因为怕线上有人在用)

二 npm包发布问题及解决

1.使用 cnpm 的注意报错：

no_perms Private mode enable, only admin can publish this module

设置回原本的就可以了：

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

建议国内采用淘宝的cnpm，发包的时候使用npm 传送门

2.

You cannot publish over the previously published version

npm包package.json中registory属性一定要填写，每次publish npm时package.json中version版本一定要大于上一次。

3.这样的报错信息，往往是没有登录成功

npm publish failed put 500  unexpected status code 401

操作npm login

4.

you do not have permission to publish "your module name". Are you logged in as the correct user?

这种很可能是你的包名已经被别人占用了，只能修改package.json中的name，重新发布。
如果你确定你的包名没有被占用，还有一种可能是本地测试的时候link过或安装过，缓存中已经存在该包，但是测试的时候信息不一致造成的，删除用户npm目录下的自己的包，尝试重新publish。

5.

Request Entity Too Large

这种一般是因为包目录下包含了多余的或者不需要上传到npmjs的文件，在包目录下新建一个.npmignore忽略了就行，规则类似.gitignore

6.

you must verify your email before publishing a new package

这种需要你先验证你的邮箱，可能网速会很慢只要你填写了一个邮件地址，npm就会发一封邮件到你的邮件地址上，打开填写的邮件地址验证即可

三 github项目徽章的添加和设置

如果想让自己的npm包看上去更高大尚一些，可以添加一些徽章，添加徽章很简单可以点击这里去添加想要的徽章

没有伞的孩纸只能拼命奔跑