npm经常使用命令小结

目录(更新于2016.09.23)：

一、认识和使用NPM

二、npm包安装模式

三、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的配置路径

四、package.json：包描述信息

五、npm使用过程当中疑点

回到顶部

一、认识和使用NPM

• 1.一、NPM是什么

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

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

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

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

• 1.二、NPM 使用介绍

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

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

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

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

因为新版的nodejs已经集成了npm，因此以前npm也一并安装好了。一样能够经过输入 "npm -v" 来测试是否成功安装。命令以下，出现版本提示表示安装成功:

$ npm -v 2.3.0

回到顶部

二、npm包安装模式

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

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

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

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

• 全局安装：package会被下载到到特定的系统目录下，安装的package可以在全部目录下使用。

回到顶部

三、npm包管理

npm的包管理命令是使用频率最高的，因此也是咱们须要紧紧记住并熟练使用的。其实无非也就是几个动做：安装、卸载、更新、查看、搜索等。

    3.一、安装模块

    本地安装，如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.二、卸载模块,好比grunt-cli

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

3.三、更新模块，好比grunt-cli,全局npm

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

3.四、查看模块，好比 grunt-cli

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

3.五、搜索模块，如 grunt-cli

• npm search grunt-cli：搜索

3.六、发布模块

• npm publish，即将本身开发的包发布到npm官网，成功以后，能够在https://www.npmjs.com/登陆查看发布的模块。而后，就能够用npm install安装了。
• npm unpublish 模块名 --force，删除已发布的模块

3.七、其余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

回到顶部

四、理解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.   其余：参见官网

回到顶部

五、npm使用过程当中疑点

5.一、理解sudo npm安装，如：$ sudo npm install -g ionic

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

 

5.二、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.三、 安装模块过程当中出现以下提示：

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进行查看。

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