npm(Node Package Manager)是Node.js的包管理工具,相当于一个在线仓库。它提供了一个公共的平台,将分散在世界各地的包集中起来,能轻松的安装、分享和管理相关的包,不用再为搜索包而烦恼,并且npm能自动处理包的依赖项。它由三部分组成:
(1)网站:可用来浏览、搜索包的信息。
(2)注册表:一个巨大的数据库,保存了每个包的信息,例如作者、版本、依赖等。
(3)命令行界面(CLI):开发者可在CLI中对包进行发布、安装、卸载等操作。
由于新版的Node.js已集成了npm,因此在安装完Node.js后就能使用npm了。
一、安装包
npm有两种安装包的方式:本地安装和全局安装,从使用的命令格式来看(如下所示),两者只差一个“-g”参数(即标志)。
npm install <package_name> [-g]
(1)如果代码要依赖于某个包(例如jquery、lodash等),那么应该用本地安装。在安装完后,就能在当前目录的node_modules目录中找到相应的包,通过require()函数就能引用到。
npm install jquery
(2)如果要将包作为一个命令行工具(例如gulp、grunt等),那么应该用全局安装。在安装完后,就能在Node.js的安装目录或/usr/local的node_modules目录中找到相应的包。
npm install gulp -g
二、package.json
package.json是一个位于项目根目录的文件,用于管理本地已安装的npm包,记录了项目的作者、依赖包、版本等各类信息。有了package.json,就能很方便的克隆一个项目,而不必再手动的安装相关的包,这样利于多人协作。
1)创建
除了原始的手动创建之外,还能通过命令“npm init”或“npm init --yes”生成符合规范的package.json文件,初始化的结果如下所示。
{ "name": "demo", "version": "1.0.0", "description": "test", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "keywords": [], "author": "strick", "license": "ISC" }
上面只列出了package.json的部分字段(属性),对它们的说明可参考表1,其中第三列会结合示例给出相应的值或用法,package.json的剩余字段可参考官方文档。
表1 package.json的字段
字段 | 描述 | 值或用法 |
name | 名称,小写且无空格,能与“-”或“_”符号混合 | "demo" |
version | 语义化的版本号(后文会有讲解) | "1.0.0" |
description | 描述信息 | "test" |
main | 程序的主入口文件 | 当执行require("demo")时,就会加载根目录下的index.js |
scripts | 脚本命令 | 在运行时需要与“npm run”配合,例如“npm run test” |
keywords | 关键字,利于检索 | [] |
author | 作者 | "strick" |
license | 许可证 | "ISC" |
2)依赖
在package.json中,有两个字段都记录着项目的依赖包,如下所列。
(1)dependencies:在生产环境中所依赖的包,其安装命令需要“--save”参数。
npm install <package_name> --save
(2)devDependencies:在开发环境中所依赖的包,其安装命令会比dependencies多一个“-dev”参数。
npm install <package_name> --save-dev
当执行下面的两条命令后。
npm install lodash --save
npm install underscore --save-dev
在package.json中就会多两段信息,如下所示。
{ "dependencies": { "lodash": "^4.17.11" }, "devDependencies": { "underscore": "^1.9.1" } }
将上述包含依赖的package.json文件分享到其它项目时,只要在该目录中运行下面的命令,就能自动安装所需的包,并且指定了包的版本,以免无法启动项目。
npm install
3)版本
npm遵循semver版本规范,使用语义化的版本号来管理包,并且能设置版本范围。一个版本号包含三位:X.Y.Z,分别代表主版本号(X)、次版本号(Y)和补丁版本号(Z),取值为非负整数,个位数不会补零。首次发布的新产品,其版本号从“1.0.0”开始。
如果要升级版本号,那么可以遵循下面所列的这三个规则。
(1)当有重大变化、不向下兼容时,递增主版本号(X),其余两位(Y和Z)置零,例如“2.0.0”。
(2)当发布了向下兼容的新功能时,递增次版本号(Y),最后一位(Z)置零,例如“1.1.0”。
(3)当只是修复向下兼容的错误时,递增补丁版本号(Z),其余两位保持不变,例如“1.1.1”。
除了可以声明一个固定版本号之外,还能通过多个符号(例如^、~、>、x、*等)指定版本号的范围。接下来只介绍其中的两个,每个符号后面都会给出对应的版本号范围。
(1)如果在版本号之前加上^,那么符合的版本号的X位要与其相同,并且剩余两位不小于指定的版本号。
^1.2.3 = [>=1.2.3 <2.0.0]
^0.2.3 = [>=0.2.3 <0.3.0]
(2)如果在版本号之前加上~,那么符合的版本号的X位和Y位要与其相同,并且Z位不小于指定的版本号。
~1.2.3 = [>=1.2.3 <1.3.0]
~0.2.3 = [>=0.2.3 <0.3.0]
三、包和模块
在Node.js和npm中,虽然对包和模块有非常具体的定义(如下所列),但是大部分人还是会混淆。
(1)包(package)是由package.json描述的文件或目录。
(2)模块(module)是任何能被Node.js的require()函数加载的文件或目录,下面是模块常见的三种形式。
1)包含package.json文件且定义了main字段的目录。
2)包含index.js文件的目录。
3)JavaScript文件。
由此可知,大多数的npm包都是模块,只有一些特殊的包(例如只提供了命令API而没有定义main入口的CLI包)不能被认为是模块。
四、常用命令
npm不仅包含基本的查看命令,例如查看版本号或包的信息等;还包含实用的辅助命令,例如查看指定的命令可组合的参数形式,如下所示。
npm -v 查看npm的版本号
npm ls 查看当前目录安装的包的信息
npm install --help 查看npm install可使用的参数形式
除了查看之外,还有其它几个常用的操作,例如安装、卸载、更新、搜索、发布等。下面以lodash为例,列出了相关的命令。
npm install lodash@4.0.1 安装4.0.1版本的lodash
npm uninstall lodash 卸载lodash
npm update lodash 更新lodash
npm search lodash 搜索lodash
npm publish lodash 发布lodash
五、淘宝npm镜像
因为npm上的包都保存在国外服务器中,所以受网络影响大,很容易出现异常。在国内推荐使用淘宝npm镜像,这是一个完整的npmjs.org镜像,同步频率为10分钟一次,保证了与官方服务同步。只需要运行下面的安装命令,就能用淘宝定制的cnpm替代默认的npm。
npm install -g cnpm --registry=https://registry.npm.taobao.org
由于cnpm的用法和npm完全一致,因此依然可以像下面这样安装lodash。
cnpm install lodash@4.0.1