NPM

基本使用

1. 安装
   较新版本 Node 自带，基本不用自己装
2. 初始化
   npm init之后一路 next
3. 安装依赖

• npm install --production安装 package.json 里已经声明了依赖（只安装 dependencies）
• npm install安装 package.json 里已经声明了依赖（包括：devDependencies 和 dependencies）

下载源

nrm

国内 npm 官方源慢，用 nrm 可以切换成淘宝的 npm 镜像源

nrm can help you easy and fast switch between different npm registries, now include: npm, cnpm, taobao, nj(nodejitsu), rednpm.

• Install

$ npm install -g nrm

• Example

$ nrm use cnpm  //switch registry to cnpm
 
    Registry has been set to: http://r.cnpmjs.org/

nrm 的原理是修改 npm 的registr配置，cnpm是 fork 一个子进程实现的（据说有问题没有用过，感觉在发布时会省点事，nrm 还得切回去）

# 建议不要用 cnpm 安装 会有各种诡异的bug 可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npm.taobao.org

alias cnpmi='npm install --registry=https://registry.npm.taobao.org/'

卡在 Building fresh packages，npm 包用到的附加无法下载？

一些 npm 包需要一些附件，这些附件通常在配置文件的 script 的 preinstall、install 或 postuninstall 中去下载，但因为墙或者网络的原因这些附件可能会无法下载或下载的很慢，所以得切换到国内的源才能获得极致的体验。

例如 puppeteer 的进行了如下配置在安装的时候下载 chromium：

{
  "name": "puppeteer",
  ...
  "scripts": {
    ...
    "install": "node install.js",
    ...
  },
  ...
},

常见的附件的下载源

puppeteer_download_host "https://npm.taobao.org/mirrors"
sass_binary_site "https://npm.taobao.org/mirrors/node-sass/"
phantomjs_cdnurl "http://cnpmjs.org/downloads"
electron_mirror "https://npm.taobao.org/mirrors/electron/"
sqlite3_binary_host_mirror "https://foxgis.oss-cn-shanghai.aliyuncs.com/"
profiler_binary_host_mirror "https://npm.taobao.org/mirrors/node-inspector/"
chromedriver_cdnurl "https://cdn.npm.taobao.org/dist/chromedriver"

使用：以解决 puppeteer 无法下载为例

npm

npm config set puppeteer_download_host=https://storage.googleapis.com.cnpmjs.org

或 yarn

yarn config set puppeteer_download_host https://npm.taobao.org/mirrors

或.npmrc

echo 'PUPPETEER_DOWNLOAD_HOST = https://npm.taobao.org/mirrors' >> .npmrc

参见：希望添加 chromium 镜像源 · Issue #1246 · cnpm/cnpmjs.org

操作模块

1. 安装，卸载模块

   npm install 模块名：安装模块（写入 package.json 中 dependencies 下的对应信息）

   npm uninstall 模块名：删除模块（删除 package.json 中 dependencies 下的对应信息）

   [--save-dev] 写入，删除 package.json 中 devDependencies 下的对应信息

   （dependencies：一般是运行时用到的模块，devDependencies：一般是开发时用到的工具的模块）

2. 查找是否安装某模块

   npm 模块名 -v

3. 查看安装的模块

   npm list [-g] [-depth n]

   -g：查看全局安装的模块

   -depth n：展示 n 层模块的依赖

PS：升级 npm 到最新版本npm install npm@latest -g

发布到 npm 社区

基本步骤

1. 在 npm 社区注册

2. npm adduser：输入用户名密码和邮箱登陆

   npm whoami：查看登陆的用户

3. 配置package.json

4. 配置.npmignore（未配置则使用.gitignore）

5. ！！！发布前确保您的包可以安装和使用（下面细说一下如何在本地测试待发布的 npm 包）

6. npm publish：发布

测试待发布的 npm 包

其实 npm 包就是一个带有package.json的文件夹。。

• 全局安装测试

cd %my-package%
npm install . -g # 当前包安装到全局

或者

cd %my-package%
npm link # 当前包连接到全局（当前包状态改变，全局会跟着改变）

• 本地安装测试

cd %some-other-folder%
npm install %my-package%

修改版本

npm version 版本号：确定版本号（格式：主版本号. 次版本号. 修订号）（可以为 major | minor | patch 等）

代码状态	阶段	规则	例
首次发布	新作品	从 1.0.0 开始	1.0.0
向后兼容的 Bug 修复	Patch release	增加最右边第一个数字	1.0.1
向后兼容的新特性	Minor release	增加中间数字，并将最后一位数重置为零	1.1.0
无法向后兼容的更改	Major release	增加第一个数字，并将中间和最后一个数字重置为零	2.0.0

参见：

• docs.npmjs.com/misc/developers.html
• About semantic versioning | npm Documentation

检查和解决隐患（vulnerabilities）

使用 npm 的安全检查。

# 检查
npm audit [--json|--parseable]
# 解决
npm audit fix [--force|--package-lock-only|--dry-run|--production|--only=dev]

详细用法：docs.npmjs.com/cli/audit