Created By JishuBao on 2019-03-08 12:38:22

Recently revised in 2019-03-08 12:38:22

 

  欢迎大家来到技术宝的掘金世界,您的star是我写文章最大的动力！     

文章简介：

1、摘要：什么是npm？

2、如何发布一个自己的npm包?

3、发布错误集锦

一、摘要：什么是npm?

 npm是javascript著名的包管理工具，是前端模块化下的一个标志性产物。简单来说，就是通过npm下载模块,复用已有的代码，提高工作效率

二、如何发布一个属于自己的npm包

1、创建一个npm账号

 在这里 ，用户名账号密码邮箱注册完后，验证以下邮箱即可。

2、初始化一个简单的项目发布

a.本地创建一个文件夹：例如JishuBao

b.执行命令进入目录:$ cd JishuBao

c.执行npm init 初始化项目。默认一路回车就行。

$ npm initThis utility will walk you through creating a package.json file.It only covers the most common items, and tries to guess sensible defaults.See `npm help json` for definitive documentation on these fieldsand exactly what they do.Use `npm install 
    
     ` afterwards to install a package andsave it as a dependency in the package.json file.Press ^C at any time to quit.package name: (jishubao)version: (1.0.0)description: a test npm publishentry point: (index.js)test command:git repository:keywords:author: jishubaolicense: (ISC)About to write to E:\MyProject\JishuBao\package.json:{  "name": "jishubao",  "version": "1.0.0",  "description": "a test npm publish",  "main": "index.js",  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"  },  "author": "jishubao",  "license": "ISC"}Is this ok? (yes) y复制代码
    

默认字段简介：name：发布的包名，默认是上级文件夹名。不得与现在npm中的包名重复。包名不能有大写字母/空格/下滑线!version：你这个包的版本，默认是1.0.0。对于npm包的版本号有着一系列的规则，模块的版本号采用X.Y.Z的格式，具体体现为：  1、修复bug，小改动，增加z。  2、增加新特性，可向后兼容，增加y  3、有很大的改动，无法向下兼容,增加xdescription：项目简介mian：入口文件，默认是Index.js，可以修改成自己的文件 scripts：包含各种脚本执行命令test：测试命令。author：写自己的账号名license：这个直接回车，开源文件协议吧，也可以是MIT，看需要吧。复制代码

d.在JishuBao文件夹中创建一个名为index.js的文件,简单的写了一下内容。

!function(){	console.log('这是技术宝测试发布的npm包');}()复制代码

3、如果本机第一次发布包(非第一次可忽略);

在终端输入npm adduser，提示输入账号，密码和邮箱，然后将提示创建成功，具体如下图。

【注意】npm adduser成功的时候默认你已经登陆了，所以可跳过第四步。

$ npm adduserUsername: user.name(自己注册的用户名)Password: user.password(自己注册的密码)Email: (this IS public) 2459666474@qq.com(自己的邮箱)Logged in as wjb666 on https://registry.npmjs.org/.(成功提示)复制代码

最后一行显示登录信息，as 后面是用户名。on 后是源地址

4、非第一次发包

 在终端输入npm login，然后输入你创建的账号和密码，和邮箱，登陆，结果同步骤三。

5、npm publish 发布包

成功发布：

$ npm publish+ jishubao@1.0.0复制代码

注意：如果项目里有部分私密的代码不想发布到npm上，可以将它写入.gitignore 或.npmignore中，上传就会被忽略了

6、查询发布的包

到npm官网全局搜索即可,如下图jishubao的npm包就此发布好了

7、安装使用方式

和其他包使用方式一致。将刚才的文件夹清空。

$ npm install jishubao --save-devnpm WARN saveError ENOENT: no such file or directory, open 'E:\MyProject\JishuBao\package.json'npm notice created a lockfile as package-lock.json. You should commit this file.npm WARN enoent ENOENT: no such file or directory, open 'E:\MyProject\JishuBao\package.json'npm WARN JishuBao No descriptionnpm WARN JishuBao No repository field.npm WARN JishuBao No README datanpm WARN JishuBao No license field.+ jishubao@1.0.0added 1 package in 1.577s复制代码

8、如何撤销发布的包

终端执行 npm unpublish

例如：

1、npm unpublish z-tool@1.0.0 删除某个版本

2、npm unpublish z-tool --force 删除整个npm市场的包

不过撤包推荐用法：

npm unpublish的推荐替代命令：npm deprecate[@] 使用这个命令，并不会在社区里撤销你已有的包，但会在任何人尝试安装这个包的时候得到警告 例如：npm deprecate z-tool '这个包我已经不再维护了哟～

【注意】如果报权限方面的错，加上--force

三、错误集锦

1、需要提高版本号

#1、发包 npm publish 失败sh-neverleave:z-tool neverleave$ npm publishnpm ERR! publish Failed PUT 400npm ERR! code E400npm ERR! deprecations must be strings : z-toolnpm ERR! A complete log of this run can be found in:npm ERR!     /Users/neverleave/.npm/_logs/2018-11-23T10_52_01_742Z-debug.logsh-neverleave:z-tool neverleave$ npm publish#2、发包 npm publish 失败sh-neverleave:z-tool neverleave$ npm publishnpm ERR! publish Failed PUT 403npm ERR! code E403npm ERR! You cannot publish over the previously published versions: 1.0.3. : z-toolnpm ERR! A complete log of this run can be found in:npm ERR!     /Users/neverleave/.npm/_logs/2018-11-23T11_24_57_662Z-debug.logsh-neverleave:z-tool neverleave$ 复制代码

2、发包 npm publish 失败

解决方案：终端执行： npm publish --access public

#1、发包 npm publish 失败sh-neverleave:npm neverleave$ npm publishnpm ERR! publish Failed PUT 400npm ERR! code E400npm ERR! unscoped packages cannot be private : z-toolnpm ERR! A complete log of this run can be found in:npm ERR!     /Users/neverleave/.npm/_logs/2018-11-23T08_44_21_310Z-debug.logsh-neverleave:npm neverleave$ #解决方案：终端执行： npm publish --access publicsh-neverleave:npm neverleave$ npm publish --access public+ z-tool@1.0.0sh-neverleave:npm neverleave$ 复制代码

3、确保登陆的用户账号正确

sh-neverleave:npm neverleave$ npm publishnpm ERR! publish Failed PUT 404npm ERR! code E404npm ERR! 404 User not found : z-toolnpm ERR! 404 npm ERR! 404  'z-tool' is not in the npm registry.npm ERR! 404 You should bug the author to publish it (or use the name yourself!)npm ERR! 404 npm ERR! 404 Note that you can also install from anpm ERR! 404 tarball, folder, http url, or git url.npm ERR! A complete log of this run can be found in:npm ERR!     /Users/neverleave/.npm/_logs/2018-11-23T07_32_28_518Z-debug.log复制代码

4、登录时需要在username 前加‘~’，具体大家可以验证

sh-neverleave:npm neverleave$ npm loginUsername: (~  neverleave) neverleavePassword: (
    

5、无权限删除线上的包（撤包有时间限制，24小时）

解决方案：加上 --force

sh-neverleave:z-tool neverleave$ npm unpublish z-toolnpm ERR! Refusing to delete entire project.npm ERR! Run with --force to do this.npm ERR! npm unpublish [<@scope>/]
    
     [@
     
      ]sh-neverleave:z-tool neverleave$ #解决方案（内部有被鄙视的话，? I sure hope you know what you are doing.）sh-neverleave:z-tool neverleave$ npm unpublish z-tool --forcenpm WARN using --force I sure hope you know what you are doing.- z-toolsh-neverleave:z-tool neverleave$ 复制代码
     
    

6、删除npm市场的包同名的24小时后才能重新发布

sh-neverleave:z-tool neverleave$ npm publishnpm ERR! publish Failed PUT 403npm ERR! code E403npm ERR! z-tool cannot be republished until 24 hours have passed. : z-toolnpm ERR! A complete log of this run can be found in:npm ERR!     /Users/neverleave/.npm/_logs/2018-11-23T11_41_24_086Z-debug.logsh-neverleave:z-tool neverleave$ 复制代码

如果你觉得我的文章还不错的话，可以给个star哦~，