1.package.json
npm install
命令根据这个配置文件,自动下载所需的模块,也就是配置项目所需的运行和开发环境。package.json
文件就是一个JSON对象,该对象的每一个成员就是当 前项目的一项设置。比如name
就是项目名称,version
是版本(遵守“大版本.次要版本.小版本”的格式)。下面是一个最简单的package.json文件,只定义两项元数据:项目名称和项目版本。
下面是一个比较完整的版本:
{
"name": "Hello World",
"version": "0.0.1",
"author": "张三",
"description": "第一个node.js程序",
"keywords":["node.js","javascript"],
"repository": {
"type": "git",
"url": "https://path/to/url"
},
"license":"MIT",
"engines": {"node": "0.10.x"},
"bugs":{"url":"http://path/to/bug","email":"bug@example.com"},
"contributors":[{"name":"李四","email":"lisi@example.com"}],
"scripts": {
"start": "node index.js"
},
"dependencies": {
"express": "latest",
"mongoose": "~3.8.3",
"handlebars-runtime": "~1.0.12",
"express3-handlebars": "~0.5.0",
"MD5": "~1.2.0"
},
"devDependencies": {
"bower": "~1.2.8"
}
}
2.package.json配置说明
- name: 项目名称
- version: 项目版本号
- description: 项目描述
- keywords: {Array}关键词,便于用户搜索到我们的项目
- homepage: 项目url主页
-
bugs: 项目问题反馈的Url或email配置
-
license: 项目许可证,让使用者知道是如何被允许使用此项目。默认是”ISC”
-
author,contributors: 作者,贡献者
-
files: 包含在项目中的文件数组。如果在数组里面声明了一个文件夹,那也会包含文件夹中的文件。可以声明一些规则来忽略部分文件。可以在项目根目录或者子目录里声明一个.npmignore。
- main: 主文件。比如默认是index.js,项目名称叫mymodule。那么require(‘mymodule’)将返回index.js返回的内容
- bin: 用来指定各个内部命令对应的可执行文件的位置。
- man: 指定了加载的入口文件,
require('moduleName')
就会加载这个文件。这个字段的默认值是模块根目录下面的index.js
。
-
scripts:
scripts
指定了运行脚本命令的npm命令行缩写,比如start指定了运行npm run start
时,所要执行的命令。下面的设置指定了
npm run preinstall
、npm run postinstall
、npm run start
、npm run test
时,所要执行的命令。
-
config:
config
字段用于添加命令行的环境变量。下面是一个package.json
然后,在server.js
脚本就可以引用config
字段的值。
用户执行npm run start
命令时,这个脚本就可以得到值。用户可以这样 npm config set foo:port 80
改变这个值。
-
dependencies,devDependencies: : 分别是项目在生产环境中和开发测试环境中依赖的包它们都指向一个对象。该对象的各个成员,分别由模块名和对应的版本要求组成,表示依赖的模块及其版本范围。
如果一个模块不在package.json
文件之中,可以单独安装这个模块,并使用相应的参数,将其写入package.json
文件之中。
上面代码表示单独安装express模块,--save
参数表示将该模块写入dependencies
属性,--save-dev
表示将该模块写入devDependencies
属性。
另:对应的版本可以加上各种限定,主要有以下几种:
1.指定版本:比如1.2.2
,遵循“大版本.次要版本.小版本”的格式规定,安装时只安装指定版本。
2.波浪号(tilde)+指定版本:比如~1.2.2
,表示安装1.2.x的最新版本(不低于1.2.2),但是不安装1.3.x,也就是说安装时不改变大版本号和次要版本号。
3.插入号(caret)+指定版本:比如ˆ1.2.2,表示安装1.x.x的最新版本(不低于1.2.2),但是不安装2.x.x,也就是说安装时不改变大版本号。需要注意的是,
如果大版本号为0, 则插入号的行为与波浪号相同,这是因为此时处于开发阶段,即使是次要版本号变动,也可能带来程序的不兼容。
4.latest:安装最新版本。
-
peerDependencies:有时,你的项目和所依赖的模块,都会同时依赖另一个模块,但是所依赖的版本不一样。比如,你的项目依赖A模块和B模块的1.0版,而A模块本身又依赖B模块的2.0版。大多数情况下,这不构成问题,B模块的两个版本可以并存,同时运行。但是,有一种情况,会出现问题,就是这种依赖关系将暴露给用户。
最典型的场景就是插件,比如A模块是B模块的插件。用户安装的B模块是1.0版本,但是A插件只能和2.0版本的B模块一起使用。这时,用户要是将1.0版本的B的实例传给A,就会出现问题。因此,需要一种机制,在模板安装的时候提醒用户,如果A和B一起安装,那么B必须是2.0模块。
peerDependencies
字段,就是用来供插件指定其所需要的主工具的版本。
上面代码指定,安装chai-as-promised
模块时,主程序chai
必须一起安装,而且chai
的版本必须是1.x
。如果你的项目指定的依赖是chai
的2.0版本,就会报错。
注意,从npm 3.0版开始,peerDependencies
不再会默认安装了。