npm 发布流程 npm 包发布 node_modules 发布
简介
本项目主要描述了npm包发布流程，仅作为小白学习npm发布学习使用。
项目案例：
- npm地址: https://www.npmjs.com/package/test-pro-xxxx
- github地址: https://github.com/loushengyue/test-projects
流程
- 在GitHub上创建一个项目（例如：test-projects）
- 克隆（git clone)到本地
- npm初始化（npm init）
- 注册npm账号及登录npm（如果您没有npm账号的话）
- 命令行登录npm账号
- npm包发布（npm publish --access=public)
- npm包版本更新
- 删除包(如果你想作死的话)
创建 GitHub 项目
创建项目属于Git操作，这里不再描述，如果您对创建GitHub项目创建与管理不熟悉的话，可以参考下列文章：
- 《GitHub项目管理基本操作》
- 《git-bash管理Github/Gitee项目常用命令》
- 《常用git命令 （使用频率最高的15个）》
例如：
https://github.com/loushengyue/test-projects
npm 初始化
在上述步骤克隆下来的项目目录（test-projects）下，执行以下命令：
npm init
按照提示完成类似以下内容的输入：
package name: (test-projects)
version: (1.0.0)
description: this is my test-project for npm publish
entry point: (index.js)
test command: hello world.
git repository: (https://github.com/loushengyue/test-projects.git)
keywords: test test-pro test-projects
author: loushengyue
license: (ISC)
说明：
| 配置项 | 功能 |
|---|---|
| package name | 项目名称（要求在npm官网具有唯一性，不允许有大写字母，通常由字母，中横线，@符号组成） |
| version | 版本号（要求每次npm publish前修改，必须大于之前的版本） |
| description | 项目描述信息（这个可以随便写点关于项目的介绍信息） |
| entry point | 入口文件，通常用index.js |
| test command | 测试命令，执行npm run test命令时的输出信息或命令 |
| git repository | 项目的GitHub地址，会在npm官网添加该项目的GitHub链接 |
| keywords | 关键词（在npm官网搜索专用关键词，能够增加搜索效率） |
| author | 作者（请写上您的大名，让别人认识你） |
| license | 证书，通行证，版权，权限（默认ISO就行） |
注册npm账号及登录npm
用浏览器打开npm官网https://www.npmjs.com/，点击sign up注册，点击log in登录。
图示：
注意： 想要发布npm包需要上述注册信息，务必牢记注册名称，密码及邮箱（例如账号：loushengyue，密码：xxxxxx，邮箱：[email protected]）。
另外，记得进入邮箱验证你的账号！！！否则会有这样的错误等着你：
you must verify your email before publishing a new package:xxxxx
命令行登录npm账号
这里的登录跟上述网页版的登录不是一个概念，这是的登录是用来发布的，上述网页版的登录是用来查看已发布的npm包信息及个人账号信息的。
在命令行工具中执行npm login命令：
$ npm login
Username: loushengyue
Password: xxxxxx
Email: (this IS public) [email protected]
Logged in as loushengyue on https://registry.npmjs.org/.
注意： 账号，密码及邮箱必须跟注册时的信息保持一致，否则无法登录。
npm包发布
首次发布命令：
npm publish --access=public
注意： 上述项目名称有可能不可用，不可用的原因通常是npm官网上已发布了相同、类似名称的项目。例如上述的test-projects项目名称就会报错：
npm ERR! publish Failed PUT 403
npm ERR! code E403
npm ERR! Package name too similar to existing packages; try renaming your package to '@loushengyue/test-projects' and publishing with 'npm publish --access=public' instead : test-projects
假如你遇到了上述问题，可以修改package.json的name值（保证它具有唯一性），例如：
"name": "test-pro-xxxx",
然后再次执行npm publish --access=public命令，当显示类似下列信息则表示发布成功：
$ npm publish --access=public
npm notice
npm notice package: [email protected]
npm notice === Tarball Contents ===
npm notice 556B package.json
npm notice 28.6kB aa.png
npm notice 3.3kB README.md
npm notice === Tarball Details ===
npm notice name: test-pro-xxxx
npm notice version: 1.0.0
npm notice package size: 29.9 kB
npm notice unpacked size: 32.4 kB
npm notice shasum: b53645b9ce51e9e7b1e6b9d7a9e346c6176c848d
npm notice integrity: sha512-RUOZ32q0TGIn6[...]+cyY2NCTUGviw==
npm notice total files: 3
npm notice
+ [email protected]
npm包版本更新
注意： 务必修改package.json文件中的version信息，通常只能递增，可以手动修改，也可以通过命令行来修改。
例如这里我发布test-pro-xxxx的1.0.1版本。
"name": "test-pro-xxxx",
"version": "1.0.1",
然后执行npm publish命令：
$ npm publish
npm notice
npm notice package: [email protected]
npm notice === Tarball Contents ===
npm notice 556B package.json
npm notice 28.6kB aa.png
npm notice 5.1kB README.md
npm notice === Tarball Details ===
npm notice name: test-pro-xxxx
npm notice version: 1.0.1
npm notice package size: 30.7 kB
npm notice unpacked size: 34.2 kB
npm notice shasum: aa3736f22702dcdf621c7573f661eef5534fe56c
npm notice integrity: sha512-p5OT3ONm+BgIJ[...]it7/CMjELwqNg==
npm notice total files: 3
npm notice
+ [email protected]
删除包
npm包发布，通常不建议删除（假如有某某用户已经使用了你的npm包，这时候删除npm包是很没道理的）。
npm unpublish 依赖包名称 --force