阮一峰源地址
注:本文主要記錄一些難以理解的屬性
- version:version是版本(遵守“大版本.次要版本.小版本”的格式)。
- scripts指定了命令縮寫,前面加上npm run即可使用后面引號(hào)內(nèi)的命令。
- dependencies字段指定了項(xiàng)目運(yùn)行所依賴的模塊,devDependencies指定項(xiàng)目開發(fā)所需要的模塊。與之相對(duì)應(yīng)的是下載時(shí)的 --save寫入運(yùn)行時(shí)依賴屬性與--save-dev寫入開發(fā)時(shí)依賴屬性。關(guān)于版本號(hào)
指定版本:比如1.2.2,遵循“大版本.次要版本.小版本”的格式規(guī)定,安裝時(shí)只安裝指定版本。
波浪號(hào)(tilde)+指定版本:比如~1.2.2,表示安裝1.2.x的最新版本(不低于1.2.2),但是不安裝1.3.x,
也就是說安裝時(shí)不改變大版本號(hào)和次要版本號(hào)。
插入號(hào)(caret)+指定版本:比如?1.2.2,表示安裝1.x.x的最新版本(不低于1.2.2),但是不安裝2.x.x,
也就是說安裝時(shí)不改變大版本號(hào)。需要注意的是,如果大版本號(hào)為0,則插入號(hào)的行為與波浪號(hào)相同,
這是因?yàn)榇藭r(shí)處于開發(fā)階段,即使是次要版本號(hào)變動(dòng),也可能帶來程序的不兼容。
latest:安裝最新版本。
- package.json文件可以手工編寫,也可以使用npm init命令自動(dòng)生成。
$ npm init
- 有了package.json文件,直接使用npm install命令,就會(huì)在當(dāng)前目錄中安裝所需要的模塊。
- peerDependencies:如果A模塊為1.0,B模塊為2.0,且只有這兩個(gè)版本可以并存,那么使用這個(gè)屬性可以限制。注意,從npm 3.0版開始,peerDependencies不再會(huì)默認(rèn)安裝了。
{
"name": "chai-as-promised",
"peerDependencies": {
"chai": "1.x"
}
}
上面代碼指定,安裝chai-as-promised模塊時(shí),主程序chai必須一起安裝,而且chai的版本必須是1.x。如果你的項(xiàng)目指定的依賴是chai的2.0版本,就會(huì)報(bào)錯(cuò)。
- bin:用于規(guī)定對(duì)應(yīng)文件的位置類似于別名
"bin": {
"someTool": "./bin/someTool.js"
}
scripts: {
start: './node_modules/bin/someTool.js build'
}
// 簡(jiǎn)寫為
scripts: {
start: 'someTool build'
}
所有node_modules/.bin/目錄下的命令,都可以用npm run [命令]的格式運(yùn)行。在命令行下,鍵入npm run,然后按tab鍵,就會(huì)顯示所有可以使用的命令。
- main:main字段指定了加載的入口文件,require('moduleName')就會(huì)加載這個(gè)文件。這個(gè)字段的默認(rèn)值是模塊根目錄下面的index.js。
-
config:原圖奉上
image.png
image.png - browser:browser指定該模板供瀏覽器使用的版本。Browserify這樣的瀏覽器打包工具,通過它就知道該打包那個(gè)文件。
"browser": {
"tipso": "./node_modules/tipso/src/tipso.js"
},
- engines:用來指定平臺(tái)node的版本或者npm版本
{ "engines" : { "node" : ">=0.10.3 <0.12" } }
{ "engines" : { "npm" : "~1.0.20" } }
- man:man用來指定當(dāng)前模塊的man文檔的位置。
"man" :[ "./doc/calc.1" ]
- preferGlobal:preferGlobal的值是布爾值,表示當(dāng)用戶不將該模塊安裝為全局模塊時(shí)(即不用–global參數(shù)),要不要顯示警告,表示該模塊的本意就是安裝為全局模塊。
- style:style指定供瀏覽器使用時(shí),樣式文件所在的位置。樣式文件打包工具parcelify,通過它知道樣式文件的打包位置。
"style": [
"./node_modules/tipso/src/tipso.css"
]

