工具系列——npm对的包管理

最近要开始学习node了，以前虽然也一直用npm但都是零零散散，如今从网上找一些关键点作下记录。

Node包管理器介绍

Node包管理器（NPM: Node Package Manager）

NPM包含三部分：一个用来存放第三方包的代码库，一个管理本地已经安装包的机制，一个用来定义包依赖关系的标准。NPM提供了一个公共的注册服 务，它包含了你们发布的全部包，并提供了一个命令行工具，用来下载，安装和管理这些包。你能够按照Node的包格式标准来制定你的包或者应用须要依赖的其 他第三方包。

虽然不用了解NPM就能够开始使用Node，可是若是要用第三方包你就必需要学习它了，由于Node自己只提供了一些低层的API，使用第三方模块 能够大幅减小开发复杂度，不用什么都得亲自编码。NPM容许你在一个沙箱里下载和使用模块，你能够尽情地试验你感兴趣的东西，而不用担忧污染全局的包环 境。

NPM和 Node之前须要独立安装，从0.6.0版本之后，NPM已经包含在了Node安装包里。

NPM模块的全局和本地模式

NPM的操做主要有两种模式：全局和本地。这两种模式会影响包存放的目录结构，以及Node加载包时的顺序。

本地模式是NPM的默认操做模式，在这个模式下，NPM只工做在工做目录下，不会形成系统范围的修改，这个模式让你在某个Node程序下尽情地安装，测试模块，而不会影响你电脑上的其余Node程序。

全局模式适合那些将被不少程序使用，并且老是被全局加载的公共模块，好比命令行工具这些公不会被应用程序直接使用的模块。

若是你不知道一个模块该用哪一个模式安装，那就应该使用本地模式。若是一个模块的做者须要某个模块被全局的安装，一般他会在安装说明里指出。

全局模式

若是你安装Node时使用的默认目录，在全局模式下面，NPM会把包安装到/usr/local/lib/node_modules。若是你执行下 面的命令，NPM会搜索并下载名为sax的最新版并安装到/usr/local/lib/node_modules/sax目录下。

$ npm install –g sax
注意：若是你当前shell用户没有足够的权限，你须要使用root用户登陆或者使用sudo来执行命令：
$ sudo npm install –g sax
随后在你的Node脚本里须要sax模块的时候，使用下面的语句来加载：
var sax = require(‘sax');
若是你没有在应用程序目录下用本地模式安装过sax，Node将会在前面的安装目录里查找名为sax的模块，不然会优先加载本地版本。

默认模式是本地模式，所以你须要在NPM命令后加上-g标记来启用全局模式。

本地模式

本地模式是Node包依赖机制的默认推荐模式，这个模式下，NPM安装的全部东西都在当前工做目录（根目录也不例外），而不会影响任何全局的设置。 这种机制可让你一个个的设置应用程序的依赖模块以及它们的版本，而不用担忧会污染全局的模块空间。这意味着你能够有依赖同一个模块不一样版本的两个应用， 它们却不会产生冲突。

在这个模式下，NPM使用当前工做目录下的node_modules目录来存放模块，好比你当前工做目录是/home/user/apps /my_app，NPM将会用/home/user/apps/my_app/node_modules来存放全部本地模块。这意味着，若是你在代码里使 用模块名来引用模块，Node首先会到这个本地的node_modules目录下查找，若是没找到才会去搜索全局的node_modules目录，本地模 块优先级老是高于全局模块。

安装模块

使用下面命令来安装一个模块的最新版本:
$ npm install <package name>

例如，下载和安装名一个名为sax的模块的最新版本，你首先须要把你应用程序的根目录设置为当前目录，而后输入：
$ npm install jquery
这个操做，会在当前目录下创建node_modules子目录（若是不存在的话），而后在下面安装sax模块。

你也能够经过下面的命令，来选择安装某个特定的版本：
$ npm install <package name>@<version spec>

使用指定的版本号替换命令里的占位符便可，好比，要下载sax模块的0.2.5版本，你只用运行：
$ npm install sax@0.2.5

或者，安装版本号小于0.3的最新版：
$ npm install sax@”<0.3”

甚至能够指定一个版本范围：
$ npm install sax@">=0.1.0 <0.3.1"

卸载模块

使用下面命令能够卸载一个本地模块：
$ npm uninstall <package name>

若是要卸载的是一个全局模块，加上-g标记便可：
$ npm uninstall -g <package name>

更新本地模块：

$ npm update <package name>

这个命令会尝试获取最新版的模块包并更新本地版本，若是本地没有安装，则会安装它，若是须要更新的是全局环境，须要加上-g标记：
$ npm update –g <package name>

使用可执行文件

模块能够包含一个或多个可执行文件，若是你使用默认目录设置来安装一个全局模块，NPM会把可执行文件安装到/usr/local/bin目录下， 这个目录一般也被设置为系统PATH环境变量的一部分。若是你局部安装这个模块，NPM会把全部可执行文件放到./node_modules/.bin目 录下。

处理依赖关系

NPM不只安装你须要的模块包，并且会安装这些模块所依赖的其它模块，好比，若是你须要安装模块A，而A又依赖模块B和C，那么在你安装A的时候B和C同时会被安装到./node_modules/A/node_modules目录下。

例如，你用下面的命令本地安装了一个叫nano的模块：
$npm install nano

NPM的输出会相似这样：

这告诉你nano模块依赖underscore和request两个模块，而且还指出了安装的版本。若是你如今去查看./node_modules/nano/node_modules目录，你会发现这两个模块已经被安装了：
$ ls node_modules/nano/node_modules
 
request underscore

使用package.json文件定义依赖关系

当开始编写一个应用程序时，能够在应用程序根目录建立一个package.json文件来定义应用程序的元数据，好比应用的名字，做者，代码库地址，联系方式等等。程序依赖的外部模块也在这个文件里指定。

若是不打算把程序发布到NPM上，就能够不用建这个文件，不过即便你的程序是私有的，这个文件其实也有用，它能够告诉NPM这个应用程序的依赖关 系。（译者注：好比你把项目源码从开发环境复制到生产环境，能够经过调用npm install来一次性安装全部依赖包，npm会经过package.json内指定的依赖关系来自动完成依赖模块的下载安装，不用本身一个个去操做，稍 候有详细介绍）

package.json是一个JSON格式的文件，包含了一系列属性，可是若是仅仅是为了说明程序的依赖关系，则只用一个 dependencies属性就行。好比，一个叫MyApp的应用程序依赖sax,nano和request模块，只须要创建这样一个 package.json：

复制代码 代码以下:

     {

                 "name" : "MyApp",

                 "version" : "1.0.0",

                 "dependencies" : {

                                  "sax" : "0.3.x",

                                  "nano" : "*",

                                  "request" : ">0.2.0"

                 }

     }

你指定了MyApp应用，依赖0.3版本的sax，任意版本的nano，以及版本高于0.2.0的request模块。

注意：你可能发现，若是你指定了name和version字段，NPM会不工做，这只会发生在旧版本的NPM，由于最初NPM是针对公共模块使用的，而不是私有程序。

而后，在应用程序的根目录，执行：

复制代码 代码以下:

$ npm install

这样，NPM就会分析依赖关系以及你本地的node_modules目录，并自动的下载和安装缺失的模块。

你也能够经过下面的命令把全部本地模块更新到符合你定义的依赖项设置的最新版本：

复制代码 代码以下:

$npm update

事实上，你仅用update方法就好了，由于它会让NPM自动获取那些缺失的依赖模块。

package.json介绍

• name
  ~ 在package.json中最重要的就是name和version字段。他们都是必须的，若是没有就没法install；
  ~ 想好名字以前先去npm registry查看一下这个名字是否已经被使用了，http://registry.npmjs.org/
  

• version
  ~ version必须能被 node-semver解析，它被包在npm的依赖中；
  ~ name和version一块儿组成的标识在假设中是惟一的。改变包应该同时改变version

• private
  ~ 若是你设置"private": true，npm就不会发布它；
  ~ 这是一个防止意外发布私有库的方式。若是你要肯定给定的包是只发布在特定registry（如内部registry）的，用publishConfighash的描述来重写registry的publish-time配置参数
  

• scripts
  ~ “scripts”是一个由脚本命令组成的hash对象，他们在包不一样的生命周期中被执行。key是生命周期事件，value是要运行的命令。

• dependencies
  ~ 依赖是给一组包名指定版本范围的一个hash。这个版本范围是一个由一个或多个空格分隔的字符串。依赖还能够用tarball或者git URL

　　以上五项仅仅是Express4 package.json使用的，其余细节可参考文档 传送门https://www.npmjs.org/doc/files/package.json.html

npm中经常使用的命令

一、npm install moduleNames：安装Node模块
安装完毕后会产生一个node_modules目录，其目录下就是安装的各个node模块。

node的安装分为全局模式和本地模式。
通常状况下会以本地模式运行，包会被安装到和你的应用程序代码的本地node_modules目录下。
在全局模式下，Node包会被安装到Node的安装目录下的node_modules下。

全局安装命令为$npm install -g moduleName。
获知使用$npm set global=true来设定安装模式，$npm get global能够查看当前使用的安装模式。

示例：
npm install express
默认会安装express的最新版本，也能够经过在后面加版本号的方式安装指定版本，如npm install express@3.0.6

npm install <name> -g  
将包安装到全局环境中

可是代码中，直接经过require()的方式是没有办法调用全局安装的包的。全局的安装是供命令行使用的，就好像全局安装了vmarket后，就能够在命令行中直接运行vm命令

npm install <name> --save  
安装的同时，将信息写入package.json中项目路径中若是有 package.json文件时，直接使用npm install方法就能够根据dependencies配置安装全部的依赖包，这样代码提交到github时，就不用提交node_modules这个文 件夹了。

二、npm view moduleNames：查看node模块的package.json文件夹
注意事项：若是想要查看package.json文件夹下某个标签的内容，可使用$npm view moduleName labelName

三、npm list：查看当前目录下已安装的node包
注意事项：Node模块搜索是从代码执行的当前目录开始的，搜索结果取决于当前使用的目录中的node_modules下的内容。$ npm list parseable=true能够目录的形式来展示当前安装的全部node包

四、npm help：查看帮助命令

五、npm view moudleName dependencies：查看包的依赖关系

六、npm view moduleName repository.url：查看包的源文件地址

七、npm view moduleName engines：查看包所依赖的Node的版本

八、npm help folders：查看npm使用的全部文件夹

九、npm rebuild moduleName：用于更改包内容后进行重建

十、npm outdated：检查包是否已通过时，此命令会列出全部已通过时的包，能够及时进行包的更新

十一、npm update moduleName：更新node模块

十二、npm uninstall moudleName：卸载node模块

1三、一个npm包是包含了package.json的文件夹，package.json描述了这个文件夹的结构。访问npm的json文件夹的方法以下：
$ npm help json
此命令会以默认的方式打开一个网页，若是更改了默认打开程序则可能不会以网页的形式打开。

1四、发布一个npm包的时候，须要检验某个包名是否已存在
$ npm search packageName

1五、npm init：会引导你建立一个package.json文件，包括名称、版本、做者这些信息等

1六、npm root：查看当前包的安装路径
npm root -g：查看全局的包的安装路径

1七、npm -v：查看npm安装的版本

免责说明

一、本博客中的文章摘自网上的众多博客，仅做为本身知识的补充和整理，并分享给其余须要的coder，不会用于商用

二、由于不少博客的地址已经记不清楚了，因此不会在这里标明出处