[TOC]

npm使用介绍

1. 常用命令

npm install express         # 安装express到项目中，安装的是最新版本
npm install express@3.0.6   # 安装express的3.0.6版本，  安装特定版本
npm install <name> -g       # 将包安装到全局环境中
npm install lodash --save   # save 在package.json文件的dependencies字段添加该package的名称和版本号
npm install lodash --save-dev # 在package.json文件的devDependencies字段添加该package的名称和版本号
npm i <name> -g             # 将包安装到全局环境中 i 是 install 的缩写，如果用i失败，则用install试试
npm init                    # 会引导你创建一个package.json文件，包括名称、版本、作者这些信息等
npm remove <name>           # 移除
npm uninstall lodash        # 卸载lodash
npm uninstall --save lodash # save 卸载的同时想把这个package包的信息从package.json文件的dependencies字段中也一并删除
npm update <name>           # 更新
npm root                    # 查看当前包的安装路径       
npm ls                      # 列出当前安装的了所有包
npm root                    # 查看当前包的安装路径
npm help                    # 帮助，如果要单独查看install命令的帮助，可以使用的npm help install
which npm                   # 确认我们现在用的npm是来自哪个目录
npm --version               # 查看版本
npm list                    # 列出自己项目已经安装过的模块
npm list --depth 1          # 列出已安装的包，深度1
npm list -g --depth 0       # 全局包
npm search mkdir            # 搜索mkdir是否存在
npm info express            # 查看包的信息

npm 命令参数：

-g：全局安装。
--save：将保存配置信息至package.json（package.json是nodejs项目配置文件）；
-dev：保存至package.json的devDependencies节点，不指定-dev将保存至dependencies节点；
-D：保存至package.json的devDependencies节点下。

2. npm一些命令介绍

2.1 npm install 安装原理

npm install 命令用来安装模块到node_modules目录。
安装之前，npm install会先检查，node_modules目录之中是否已经存在指定模块。如果存在，就不再重新安装了，即使远程仓库已经有了一个新版本，也是如此。
如果你希望，一个模块不管是否安装过，npm 都要强制重新安装，可以使用-f或--force参数。

npm install <packageName> --force

2.2 npm update

如果想更新已安装模块，就要用到npm update命令。

npm update <packageName>

它会先到远程仓库查询最新版本，然后查询本地版本。如果本地版本不存在，或者远程版本较新，就会安装。

2.3 registry

npm update命令怎么知道每个模块的最新版本呢？
答案是 npm 模块仓库提供了一个查询服务，叫做 registry 。以 npmjs.org 为例，它的查询服务网址是 :
https://registry.npmjs.org/
这个网址后面跟上模块名，就会得到一个 JSON 对象，里面是该模块所有版本的信息。比如，访问https://registry.npmjs.org/react ，就会看到 react 模块所有版本的信息。
它跟下面命令的效果是一样的。

$ npm view react
# npm view 的别名
$ npm info react
$ npm show react
$ npm v react

registry 网址的模块名后面，还可以跟上版本号或者标签，用来查询某个具体版本的信息。比如，访问 https://registry.npmjs.org/react/v0.14.6 ，就可以看到 React 的 0.14.6 版。
返回的 JSON 对象里面，有一个dist.tarball属性，是该版本压缩包的网址。

dist: {
  shasum: '2a57c2cf8747b483759ad8de0fa47fb0c5cf5c6a',
  tarball: 'http://registry.npmjs.org/react/-/react-0.14.6.tgz' 
},

到这个网址下载压缩包，在本地解压，就得到了模块的源码。npm install和npm update命令，都是通过这种方式安装模块的。

2.4 缓存目录

npm install或npm update命令，从 registry 下载压缩包之后，都存放在本地的缓存目录。
这个缓存目录，在 Linux 或 Mac 默认是用户主目录下的.npm目录，在 Windows 默认是%AppData%/npm-cache。通过配置命令，可以查看这个目录的具体位置。

$ npm config get cache
$HOME/.npm

你最好浏览一下这个目录。

$ ls ~/.npm 
# 或者
$ npm cache ls

你会看到里面存放着大量的模块，储存结构是{cache}/{name}/{version}。

$ npm cache ls react
~/.npm/react/react/0.14.6/
~/.npm/react/react/0.14.6/package.tgz
~/.npm/react/react/0.14.6/package/
~/.npm/react/react/0.14.6/package/package.json

每个模块的每个版本，都有一个自己的子目录，里面是代码的压缩包package.tgz文件，以及一个描述文件package/package.json。
除此之外，还会生成一个{cache}/{hostname}/{path}/.cache.json文件。比如，从 npm 官方仓库下载 react 模块的时候，就会生成registry.npmjs.org/react/.cache.json文件。
这个文件保存的是，所有版本的信息，以及该模块最近修改的时间和最新一次请求时服务器返回的 ETag 。

{
  "time":{
    "modified":"2016-01-06T23:52:45.571Z",
    // ...
  },
  "_etag":"\"7S37I0775YLURCFIO8N85FO0F\""
}

对于一些不是很关键的操作（比如npm search或npm view），npm会先查看.cache.json里面的模块最近更新时间，跟当前时间的差距，是不是在可接受的范围之内。如果是的，就不再向远程仓库发出请求，而是直接返回.cache.json的数据。
.npm目录保存着大量文件，清空它的命令如下。

$ rm -rf ~/.npm/*
# 或者
$ npm cache clean

2.5 模块的安装过程

Node模块的安装过程是这样的:

1. 发出npm install命令
2. npm 向 registry 查询模块压缩包的网址
3. 下载压缩包，存放在~/.npm目录
4. 解压压缩包到当前项目的node_modules目录

注意，一个模块安装以后，本地其实保存了两份。一份是~/.npm目录下的压缩包，另一份是node_modules目录下解压后的代码。
但是，运行npm install的时候，只会检查node_modules目录，而不会检查~/.npm目录。也就是说，如果一个模块在～/.npm下有压缩包，但是没有安装在node_modules目录中，npm 依然会从远程仓库下载一次新的压缩包。
这种行为固然可以保证总是取得最新的代码，但有时并不是我们想要的。最大的问题是，它会极大地影响安装速度。即使某个模块的压缩包就在缓存目录中，也要去远程仓库下载，这怎么可能不慢呢？
另外，有些场合没有网络（比如飞机上），但是你想安装的模块，明明就在缓存目录之中，这时也无法安装。

2.6 --cache-min 参数

为了解决这些问题，npm 提供了一个--cache-min参数，用于从缓存目录安装模块。
--cache-min参数指定一个时间（单位为分钟），只有超过这个时间的模块，才会从 registry 下载。

$ npm install --cache-min 9999999 <package-name>

上面命令指定，只有超过999999分钟的模块，才从 registry 下载。实际上就是指定，所有模块都从缓存安装，这样就大大加快了下载速度。
它还有另一种写法:

$ npm install --cache-min Infinity <package-name>

但是，这并不等于离线模式，这时仍然需要网络连接。因为现在的--cache-min实现有一些问题。

（1）如果指定模块不在缓存目录，那么 npm 会连接 registry，下载最新版本。这没有问题，但是如果指定模块在缓存目录之中，npm 也会连接 registry，发出指定模块的 etag ，服务器返回状态码304，表示不需要重新下载压缩包。（2）如果某个模块已经在缓存之中，但是版本低于要求，npm会直接报错，而不是去 registry 下载最新版本。

npm 团队知道存在这些问题，正在重写 cache。并且，将来会提供一个--offline参数，使得 npm 可以在离线情况下使用。
不过，这些改进没有日程表。所以，当前使用--cache-min改进安装速度，是有问题的。

3. 更换npm的源地址:npm config set registry

查看npm包的源地址（包下载地址）：

npm config get registry 
https://registry.npmjs.org/

更换npm的源地址:

// 淘宝源
npm config set registry https://registry.npm.taobao.org  
// 自己本来的源
npm config set registry https://registry.npmjs.org/

参考链接：http://blog.csdn.net/v2810769/article/details/52585662

4. npm的其他配置:关闭进度条，显示每个请求

4.1 显示npm发的每一个请求

npm config set loglevel http

执行这个命令后，终端不会有任何显示。

4.2 关闭npm安装包时显示的进度条

npm config set progress false

执行这个命令后，终端不会有任何显示。

5. npm安装本地包离线包

5.1 从npm仓库获取离线包

注意：这个方式获取的包在安装的时候，这个包依赖的其他的包还是会需要从网络中的npm仓库冲拉取的。

在已经安装了包的项目里面，使用npm info packageName来获取包信息：

~ npm info http-server # 也是可以查看特定版本的：npm info http-server@0.11.1
npm http fetch GET 200 https://registry.npm.taobao.org/http-server 343ms

http-server@0.12.3 | MIT | deps: 10 | versions: 40
A simple zero-configuration command-line http server
https://github.com/http-party/http-server#readme

bin: http-server, hs

dist
.tarball: https://registry.npm.taobao.org/http-server/download/http-server-0.12.3.tgz
.shasum: ba0471d0ecc425886616cb35c4faf279140a0d37

dependencies:
basic-auth: ^1.0.3    minimist: ^1.2.5   colors: ^1.4.0        opener: ^1.5.1

其中.tarball: https://registry.npm.taobao.org/http-server/download/http-server-0.12.3.tgz，这行中的链接就是这个包的下载链接，在浏览器中打开这个链接下载包。

5.2 从本地已经安装的包中提取离线包

注意：这种方式把包和包的依赖包都打包了，做到了真正的离线安装这个包。

1、安装打包离线工具npm-pack-all：

~ npm install npm-pack-all -g

2、全局安装需要打包的包，并进入到这个包的全局安装路径中，注意：只有安装在全局中，才能把这个包的依赖放到自己的文件夹中，这样打包就能全部打包了。

~ npm i http-server -g

然后打开npm全局安装的文件夹，终端中使用npm root -g 来查看npm全局的安装路径：

~ npm root -g

# Mac电脑的路径
/usr/local/lib/node_modules
# window电脑一般：C:\Users\用户名\AppData\Roaming\npm\node_modules

在全局安装路径中找到包后进入包中然后终端运行命令打包：

~ cd /usr/local/lib/node_modules/http-server
~ npm-pack-all

npm notice integrity:     sha512-G0A/WdHj+kDOe[...]DXKdS6OL6bKcw==
npm notice total files:   306                                     
npm notice 
http-server-0.11.1.tgz
Restoring original package.json and lock files

命令执行结束后，会在文件夹中生成一个http-server-0.11.1.tgz这个文件就是最终的离线包。把这个包拿出来即可。

5.3 安装离线npm包

把下载的包解压放到要安装的项目中，然后终端使用如下命令：

~ npm install http-server-0.11.1.tgz

+ http-server@0.11.1
added 1 package from 1 contributor in 0.879s

3 packages are looking for funding
  run `npm fund` for details

cnpm 介绍

说明：因为npm安装插件是从国外服务器下载，受网络影响大，可能出现异常，如果npm的服务器在中国就好了，所以我们乐于分享的淘宝团队干了这事。来自官网：“这是一个完整 npmjs.org 镜像，你可以用此代替官方版本(只读)，同步频率目前为 10分钟一次以保证尽量与官方服务同步。” 这就是cnpm.
官方网址：http://npm.taobao.org
安装：命令提示符执行npm install cnpm -g --registry=https://registry.npm.taobao.org或npm i -g cnpm
安装完后最好查看其版本号cnpm -v或关闭命令提示符重新打开，安装完直接使用有可能会出现错误
cnpm跟npm用法完全一致，只是在执行命令时将npm改为cnpm。

参考链接

http://blog.csdn.net/haidaochen/article/details/8546796/
http://www.nodeclass.com/articles/810142
http://www.cnblogs.com/jiuyi/p/5353676.html

NPM使用介绍