npm常用命令小结

目录(更新于2016.09.23)：

1、认识和使用NPM

2、npm包安装模式

3、npm包管理(package的安装、卸载、升级、查看、搜索、发布,其他等)

• npm install [-g] 本地或全局安装模块
• npm uninstall [-g] 本地或全局卸载模块
• npm update 更新模块
• npm ls 查看安装的模块
• npm list 列出已安装模块
• npm show  显示模块详情
• npm info 查看模块的详细信息
• npm search 搜索模块
• npm publish 发布模块
• npm unpublish 删除已发布的模块
• npm -v 或 npm version显示版本信息
• npm view npm versions 列出npm 的所有有效版本
• npm install -g npm@2.14.14 /npm update -g npm@2.14.14  安装指定的npm版本
• npm init 引导创建一个package.json文件，包括名称、版本、作者这些信息等
• npm outdated  #检查模块是否已经过时
• npm root  [-g] 查看包的安装路径，输出 node_modules的路径，
• npm help 查看某条命令的详细帮助 例如输入npm help install
• npm config 管理npm的配置路径

4、package.json：包描述信息

5、npm使用过程中疑点

回到顶部

1、认识和使用NPM

• 1.1、NPM是什么

NPM（node package manager），通常称为node包管理器。顾名思义，它的主要功能就是管理node包，包括：安装、卸载、更新、查看、搜索等。

npm的背后，是基于couchdb的一个数据库，详细记录了每个包的信息，包括作者、版本、依赖、授权信息等。它的一个很重要的作用就是：将开发者从繁琐的包管理工作（版本、依赖等）中解放出来，更加专注于功能的开发。

npm官网：https://npmjs.org/

官网文档：https://docs.npmjs.com

• 1.2、NPM 使用介绍

NPM是随同NodeJS一起安装的包管理工具，能解决NodeJS代码部署上的很多问题，常见的使用场景有以下几种：

    - 允许用户从NPM服务器下载别人编写的第三方包到本地使用。

    - 允许用户从NPM服务器下载并安装别人编写的命令行程序到本地使用。

    - 允许用户将自己编写的包或命令行程序上传到NPM服务器供别人使用。

由于新版的nodejs已经集成了npm，所以之前npm也一并安装好了。同样可以通过输入 "npm -v" 来测试是否成功安装。命令如下，出现版本提示表示安装成功:

$ npm -v
2.3.0

回到顶部

2、npm包安装模式

在具体介绍npm包的管理之前，我们首先得来了解一下npm包的两种安装模式。

本地安装 vs 全局安装（重要）

node包的安装分两种：本地安装、全局安装。两者的区别如下，后面会通过简单例子说明

• 本地安装：package会被下载到当前所在目录，也只能在当前目录下使用。

• 全局安装：package会被下载到到特定的系统目录下，安装的package能够在所有目录下使用。

回到顶部

3、npm包管理

npm的包管理命令是使用频率最高的，所以也是我们需要牢牢记住并熟练使用的。其实无非也就是几个动作：安装、卸载、更新、查看、搜索等。

    3.1、安装模块

    本地安装，如grunt-cli

• npm install grunt-cli：安装包grunt-cli，默认会安装最新的版本
• npm install grunt-cli@"0.1.9"：安装0.1.9版本的grunt-cli
• npm install grunt-cli --save 或 npm install grunt-cli -S：安装包grunt-cli并将信息将加入到package.json文件的dependencies（生产阶段的依赖）
• npm install grunt-cli --save-dev 或 npm install grunt-cli -D:安装包grunt-cli并将包信息写入package.json文件的devDependencies（开发阶段的依赖）配置中，这样代码提交到github时，就不用提交node_modules这个文件.
• npm install grunt-cli --save-optional 或 npm install grunt-cli -O:安装包grunt-cli并将信息将加入到optionalDependencies（可选阶段的依赖）
  
  模块的依赖都被写入了package.json文件后，他人打开项目的根目录（项目开源、内部团队合作），使用npm install命令可以根据dependencies配置安装所有的依赖包

npm install

普通安装完毕后会产生一个node_modules目录，其目录下就是安装的各个node模块。

   全局安装，如npm

• npm install -g npm :全局安装npm 

• npm install -g npm@2.14.14 ：安装指定的npm版本，同时也是降低和更新npm版本的方法；

全局安装模块的目录一般为c:\User\Administrator\AppData\Roaming\npm\node_modules\下；

全局安装的模块，在代码中直接通过require()的方式是没有办法调用到的。全局的安装是供命令行使用的，就好像全局安装了vmarket后，就可以在命令行中直接运行vm命令。也就是可以直接在cmd的命令行中使用。

3.2、卸载模块,比如grunt-cli

• npm uninstall grunt-cli: 卸载包grunt-cli
• npm uninstall grunt-cli@"0.1.9": 卸载0.1.9版本的grunt-cli

3.3、更新模块，比如grunt-cli,全局npm

• npm update #升级当前目录下的项目的所有模块
• npm update grunt-cli 更新
• npm update -g npm@3.14.14，安装指定的npm版本，同时也是更新npm版本的方法；

3.4、查看模块，比如 grunt-cli

• npm ls grunt-cli：查看特定包grunt-cli的信息
• npm info grunt-cli：查看详细的输出信息（包括作者、版本、依赖等）。
• npm list #列出已安装模块
• npm show grunt-cli #显示模块详情

3.5、搜索模块，如 grunt-cli

• npm search grunt-cli：搜索

3.6、发布模块

• npm publish，即将自己开发的包发布到npm官网，成功之后，可以在https://www.npmjs.com/登录查看发布的模块。然后，就可以用npm install安装了。
• npm unpublish 模块名 --force，删除已发布的模块

3.7、其他package安装命令

运行如下命令，列出所有npm install可能的参数形式

• npm -v 或npm version 显示版本
• npm init 会引导你创建一个package.json文件，包括名称、版本、作者这些信息等
• npm view npm versions  列出npm 的所有有效版本

• npm outdated  检查模块是否已经过时，此命令会列出所有已经过时的包，可以及时进行包的更新
• npm root  [-g]查看包的安装路径，输出 node_modules的路径

　　

• npm help 查看某条命令的详细帮助 例如输入npm help install，系统在默认的浏览器或者默认的编辑器中打开本地nodejs安装包的文件/nodejs/node_modules/npm/html/doc/cli/npm-install.html
• npm config 管理npm的配置路径

基础语法

npm config set <key> <value> [-g|--global]
npm config get <key>
npm config delete <key>
npm config list
npm config edit
npm get <key>
npm set <key> <value> [-g|--global]

对于config这块用得最多应该是设置代理，解决npm安装一些模块失败的问题

例如我在公司内网，因为公司的防火墙原因，无法完成任何模块的安装，这个时候设置代理可以解决

npm config set proxy=http://dev-proxy.oa.com:8080

又如国内的网络环境问题，某官方的IP可能被和谐了，幸好国内有好心人，搭建了镜像，此时我们简单设置镜像

npm config set registry="http://r.cnpmjs.org"

也可以临时配置，如安装淘宝镜像

npm install -g cnpm --registry=https://registry.npm.taobao.org

回到顶部

4、理解package.json字段

字段相当多，但最重要的的是下面几个

1.   name: package的名字（由于他会成为url的一部分，所以 non-url-safe 的字母不会通过，也不允许出现"."、"_"），最好先在http://registry.npmjs.org/上搜下你取的名字是否已经存在
2.   version: package的版本，当package发生变化时，version也应该跟着一起变化，同时，你声明的版本需要通过semver的校验（semver可自行谷歌）
3.   dependencies: package的应用依赖模块，应用依赖模块会安装到当前模块的node_modules目录下
4.   devDependencies：package的开发依赖模块，即别人要在这个package上进行开发
5.   其他：参见官网

回到顶部

5、npm使用过程中疑点

5.1、理解sudo npm安装，如：$ sudo npm install -g ionic

sudo命令是在linux环境中以管理员身份执行后面的命令。如为当前账户添加node_modules目录读写权限，命令为sudo chown -R $(whoami) ~/.npm。

 

5.2、npm install会根据package.json来安装相应的依赖模块，但是安装完成后会出现很多的文件夹，是什么原因呢？

原因：这是 npm3 中作出的改变，也是最大的改变之一，5.0 用的是 npm3。npm -v 可以查看 npm 版本。

如果你想按照package.json中的要求安装模块，你需要npm install 指定版本(这个版本必须还3.0以前的版本)，执行命令：

npm view npm versions:列出npm 的所有有效版本

npm install -g npm@2.14.14  ,安装指定的npm版本，同时也是降低npm版本的方法；

npm update -g npm@3.14.14，安装指定的npm版本，同时也是更新npm版本的方法；

 

5.3、 安装模块过程中出现如下提示：

fs: re-evaluating native module sources is not supported.
If you are using the graceful-fs module, please update it to a more recent version.

如图：

原因是现在的Node版本是v6.2.1 ;升级到最新版本的node了，又还原回原来的版本了5.7.0稳定版了，也可以是一个稳定的版本.Node.js 5.7.0 稳定版下载地址

 

 

 

 

写在后面:内容只是简单地把最常见的命令，以及一些需要了解的内容列了出来。如要进一步了解，可参考官网说明。此外，npm help是我们最好的朋友，如果忘了有哪些命令，命令下有哪些参数，可通过help进行查看。

最关键的：如果文章内容有误，请指出！！！