前言

大家都知道在一個(gè)Node.js項(xiàng)目中，package.json幾乎是一個(gè)必須的文件，它的主要作用就是管理項(xiàng)目中所使用到的外部依賴包，同時(shí)它也是npm命令的入口文件。下面話不多說了，來(lái)一起看看詳細(xì)的介紹把。

npm 目前支持以下幾類依賴包管理：

• dependencies
• devDependencies
• peerDependencies
• optionalDependencies
• bundledDependencies / bundleDependencies

如果你想使用哪種依賴管理，那么你可以將它放在package.json中對(duì)應(yīng)的依賴對(duì)象中，比如：

 "devDependencies": {
 "fw2": "^0.3.2",
 "grunt": "^1.0.1",
 "webpack": "^3.6.0"
 },
 "dependencies": {
 "gulp": "^3.9.1",
 "hello-else": "^1.0.0"
 },
 "peerDependencies": { },
 "optionalDependencies": { },
 "bundledDependencies": [] 

下面我們一一來(lái)看：

dependencies

應(yīng)用依賴，或者叫做業(yè)務(wù)依賴，這是我們最常用的依賴包管理對(duì)象！它用于指定應(yīng)用依賴的外部包，這些依賴是應(yīng)用發(fā)布后正常執(zhí)行時(shí)所需要的，但不包含測(cè)試時(shí)或者本地打包時(shí)所使用的包?？墒褂孟旅娴拿顏?lái)安裝：

npm install packageName --save

dependencies是一個(gè)簡(jiǎn)單的JSON對(duì)象，包含包名與包版本，其中包版本可以是版本號(hào)或者URL地址。比如：

{ 
 "dependencies" :{ 
 "foo" : "1.0.0 - 2.9999.9999", // 指定版本范圍
 "bar" : ">=1.0.2 <2.1.2", 
 "baz" : ">1.0.2 <=2.3.4", 
 "boo" : "2.0.1", // 指定版本
 "qux" : "<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0", 
 "asd" : "http://asdf.com/asdf.tar.gz", // 指定包地址
 "til" : "~1.2", // 最近可用版本
 "elf" : "~1.2.3", 
 "elf" : "^1.2.3", // 兼容版本
 "two" : "2.x", // 2.1、2.2、...、2.9皆可用
 "thr" : "*", // 任意版本
 "thr2": "", // 任意版本
 "lat" : "latest", // 當(dāng)前最新
 "dyl" : "file:../dyl", // 本地地址
 "xyz" : "git+ssh://git@github.com:npm/npm.git#v1.0.27", // git 地址
 "fir" : "git+ssh://git@github.com:npm/npm#semver:^5.0",
 "wdy" : "git+https://isaacs@github.com/npm/npm.git",
 "xxy" : "git://github.com/npm/npm.git#v1.0.27",
 }
}

devDependencies

開發(fā)環(huán)境依賴，僅次于dependencies的使用頻率！它的對(duì)象定義和dependencies一樣，只不過它里面的包只用于開發(fā)環(huán)境，不用于生產(chǎn)環(huán)境，這些包通常是單元測(cè)試或者打包工具等，例如gulp, grunt, webpack, moca, coffee等，可使用以下命令來(lái)安裝：

npm install packageName --save-dev

舉個(gè)栗子：

{ "name": "ethopia-waza",
 "description": "a delightfully fruity coffee varietal",
 "version": "1.2.3",
 "devDependencies": {
 "coffee-script": "~1.6.3"
 },
 "scripts": {
 "prepare": "coffee -o lib/ -c src/waza.coffee"
 },
 "main": "lib/waza.js"
}

prepare腳本會(huì)在發(fā)布前運(yùn)行，因此使用者在編譯項(xiàng)目時(shí)不用依賴它。在開發(fā)模式下，運(yùn)行npm install, 同時(shí)也會(huì)執(zhí)行prepare腳本，開發(fā)時(shí)可以很容易的測(cè)試。

至此，你理解了--save和--save-dev的區(qū)別了嗎？

peerDependencies

同等依賴，或者叫同伴依賴，用于指定當(dāng)前包（也就是你寫的包）兼容的宿主版本。如何理解呢？ 試想一下，我們編寫一個(gè)gulp的插件，而gulp卻有多個(gè)主版本，我們只想兼容最新的版本，此時(shí)就可以用同等依賴（peerDependencies）來(lái)指定：

{
 "name": "gulp-my-plugin",
 "version": "0.0.1",
 "peerDependencies": {
 "gulp": "3.x"
 }
}

當(dāng)別人使用我們的插件時(shí)，peerDependencies就會(huì)告訴明確告訴使用方，你需要安裝該插件哪個(gè)宿主版本。

通常情況下，我們會(huì)在一個(gè)項(xiàng)目里使用一個(gè)宿主（比如gulp）的很多插件，如果相互之間存在宿主不兼容，在執(zhí)行npm install時(shí)，cli會(huì)拋出錯(cuò)誤信息來(lái)告訴我們，比如：

npm ERR! peerinvalid The package gulp does not satisfy its siblings' peerDependencies requirements!
npm ERR! peerinvalid Peer gulp-cli-config@0.1.3 wants gulp@~3.1.9
npm ERR! peerinvalid Peer gulp-cli-users@0.1.4 wants gulp@~2.3.0

運(yùn)行命令npm install gulp-my-plugin --save-dev來(lái)安裝我們插件，我們來(lái)看下依賴圖譜：

├── gulp-my-plugin@0.0.1
└── gulp@3.9.1

OK, Nice!

注意，npm 1 與 npm 2 會(huì)自動(dòng)安裝同等依賴，npm 3 不再自動(dòng)安裝，會(huì)產(chǎn)生警告！手動(dòng)在package.json文件中添加依賴項(xiàng)可以解決。

optionalDependencies

可選依賴，如果有一些依賴包即使安裝失敗，項(xiàng)目仍然能夠運(yùn)行或者希望npm繼續(xù)運(yùn)行，就可以使用optionalDependencies。另外optionalDependencies會(huì)覆蓋dependencies中的同名依賴包，所以不要在兩個(gè)地方都寫。

舉個(gè)栗子，可選依賴包就像程序的插件一樣，如果存在就執(zhí)行存在的邏輯，不存在就執(zhí)行另一個(gè)邏輯。

try {
 var foo = require('foo')
 var fooVersion = require('foo/package.json').version
} catch (er) {
 foo = null
}
if ( notGoodFooVersion(fooVersion) ) {
 foo = null
}

// .. then later in your program ..

if (foo) {
 foo.doFooThings()
}

bundledDependencies / bundleDependencies

打包依賴，bundledDependencies是一個(gè)包含依賴包名的數(shù)組對(duì)象，在發(fā)布時(shí)會(huì)將這個(gè)對(duì)象中的包打包到最終的發(fā)布包里。如：

{
 "name": "fe-weekly",
 "description": "ELSE 周刊",
 "version": "1.0.0",
 "main": "index.js",
 "devDependencies": {
 "fw2": "^0.3.2",
 "grunt": "^1.0.1",
 "webpack": "^3.6.0"
 },
 "dependencies": {
 "gulp": "^3.9.1",
 "hello-else": "^1.0.0"
 },
 "bundledDependencies": [
 "fw2",
 "hello-else"
 ]
}

執(zhí)行打包命令npm pack, 在生成的fe-weekly-1.0.0.tgz包中，將包含fw2和hello-else。 但是值得注意的是，這兩個(gè)包必須先在devDependencies或dependencies聲明過，否則打包會(huì)報(bào)錯(cuò)。

總結(jié)

以上就是目前npm支持的依賴管理，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，如果有疑問大家可以留言交流，謝謝大家對(duì)腳本之家的支持。

最新評(píng)論