nodejs
的出現(xiàn)盲镶,可以算是前端里程碑式的一個(gè)事件,它讓前端攻城獅們擺脫了瀏覽器的束縛蝌诡,踏上了一個(gè)更加寬廣的舞臺(tái)溉贿。前端的可能性,從此更加具有想象空間浦旱。
隨著一系列基于nodejs
的應(yīng)用/工具的出現(xiàn)宇色,工作中與nodejs
打交道的機(jī)會(huì)越來越多。無論在node
應(yīng)用的開發(fā)颁湖,還是使用中宣蠕,包管理都扮演著一個(gè)很重要的作用。NPM(node package manager)
甥捺,作為node
的包管理工具抢蚀,極大地便利了我們的開發(fā)工作,很有必要了解一下镰禾。
NPM是什么
NPM(node package manager)
皿曲,通常稱為node
包管理器唱逢。顧名思義,它的主要功能就是管理node
包屋休,包括:安裝坞古、卸載、更新劫樟、查看痪枫、搜索、發(fā)布等叠艳。
npm
的背后听怕,是基于couchdb
的一個(gè)數(shù)據(jù)庫,詳細(xì)記錄了每個(gè)包的信息虑绵,包括作者尿瞭、版本、依賴翅睛、授權(quán)信息等声搁。它的一個(gè)很重要的作用就是:將開發(fā)者從繁瑣的包管理工作(版本、依賴等)中解放出來捕发,更加專注于功能的開發(fā)疏旨。
npm
官網(wǎng):https://npmjs.org/
npm
官方文檔:https://npmjs.org/doc/README.html
我們需要了解什么
npm
的安裝、卸載扎酷、升級妒挎、配置
npm
的使用:package
的安裝、卸載尸红、升級兄旬、查看、搜索凡纳、發(fā)布
npm
包的安裝模式:本地 vs
全局
package.json
:包描述信息
package
版本:常見版本聲明形式
npm
包安裝模式
在具體介紹npm
包的管理之前窃植,我們首先得來了解一下npm
包的兩種安裝模式。
本地安裝 vs 全局安裝(重要)
node
包的安裝分兩種:本地安裝荐糜、全局安裝巷怜。兩者的區(qū)別如下,后面會(huì)通過簡單例子說明
本地安裝:package會(huì)被下載到當(dāng)前所在目錄暴氏,也只能在當(dāng)前目錄下使用延塑。
全局安裝:package會(huì)被下載到到特定的系統(tǒng)目錄下,安裝的package能夠在所有目錄下使用答渔。
npm install pkg - 本地安裝
運(yùn)行如下命令关带,就會(huì)在當(dāng)前目錄下安裝grunt-cli
(grunt命令行工具)
npm install grunt-cli
安裝結(jié)束后,當(dāng)前目錄下回多出一個(gè)node_modules
目錄研儒,grunt-cli
就安裝在里面豫缨。同時(shí)注意控制臺(tái)輸出的信息:
[grunt-cli@0.1.9](mailto:grunt-cli@0.1.9) node_modules/grunt-cli
├── [resolve@0.3.1](mailto:resolve@0.3.1)
├── [nopt@1.0.10](mailto:nopt@1.0.10) ([abbrev@1.0.4](mailto:abbrev@1.0.4))
└── [findup-sync@0.1.2](mailto:findup-sync@0.1.2) ([lodash@1.0.1](mailto:lodash@1.0.1), [glob@3.1.21](mailto:glob@3.1.21))
簡單說明一下:
grunt-cli@0.1.9
:當(dāng)前安裝的package
為grunt-cli
独令,版本為0.19
node_modules/grunt-cli
:安裝目錄
resolve@0.3.1
:依賴的包有resolve
、nopt
好芭、findup-sync
燃箭,它們各自的版本、依賴在后面的括號里列出來
npm install -g pkg- 全局安裝
上面已經(jīng)安裝了grunt-cli
舍败,然后你跑到其他目錄下面運(yùn)行如下命令
grunt
果斷提示你grunt命令不存在招狸,為什么呢?因?yàn)樯厦嬷皇沁M(jìn)行了本地安裝邻薯,grunt命令只能在對應(yīng)安裝目錄下使用裙戏。
-bash: grunt: command not found
如果為了使用grunt命令,每到一個(gè)目錄下都得重新安裝一次厕诡,那不抓狂才怪累榜。腫么辦呢?
很簡單灵嫌,采用全局安裝就行了壹罚,很簡單,加上參數(shù)-g
就可以了
npm install -g grunt-cli
于是寿羞,在所有目錄下都可以無壓力使用grunt
命令了猖凛。這個(gè)時(shí)候,你會(huì)注意到控制臺(tái)輸入的信息有點(diǎn)不同绪穆。主要的區(qū)別在于安裝目錄辨泳,現(xiàn)在變成了
/usr/local/lib/node_modules/grunt-cli
,/usr/local/lib/node_modules/
也就是之前所說的全局安裝目錄啦玖院。
[grunt-cli@0.1.9](mailto:grunt-cli@0.1.9) /usr/local/lib/node_modules/grunt-cli
├── [resolve@0.3.1](mailto:resolve@0.3.1)
├── [nopt@1.0.10](mailto:nopt@1.0.10) ([abbrev@1.0.4](mailto:abbrev@1.0.4))
└── [findup-sync@0.1.2](mailto:findup-sync@0.1.2) ([lodash@1.0.1](mailto:lodash@1.0.1), [glob@3.1.21](mailto:glob@3.1.21))
npm
包管理
npm
的包管理命令是使用頻率最高的菠红,所以也是我們需要牢牢記住并熟練使用的。其實(shí)無非也就是幾個(gè)動(dòng)作:安裝司恳、卸載途乃、更新、查看扔傅、搜索、發(fā)布等烫饼。
安裝最新版本的grunt-cli
npm install grunt-cli
安裝0.1.9版本的grunt-cli
npm install [grunt-cli@"0.1.9](mailto:grunt-cli@%220.1.9)"
通過package.json
進(jìn)行安裝
如果我們的項(xiàng)目依賴了很多package
猎塞,一個(gè)一個(gè)地安裝那將是個(gè)體力活。我們可以將項(xiàng)目依賴的包都在package.json
這個(gè)文件里聲明杠纵,然后一行命令搞定
npm install
其他package
安裝命令
運(yùn)行如下命令荠耽,列出所有npm install
可能的參數(shù)形式
npm install --help
輸出如下,有興趣的童鞋可以了解下
npm install <tarball file>
npm install <tarball url>
npm install <folder>
npm install <pkg>
npm install <pkg>@<tag>
npm install <pkg>@<version>
npm install <pkg>@<version range>
卸載grunt-cli
比如卸載grunt-cli
npm uninstall grunt-cli
卸載0.1.9版本的grunt-cli
npm uninstall [grunt-cli@"0.1.9](mailto:grunt-cli@%220.1.9)"
npm ls
:查看安裝了哪些包
運(yùn)行如下命令比藻,就可以查看當(dāng)前目錄安裝了哪些package
npm ls
輸出如下
/private/tmp/npm
└─┬ [grunt-cli@0.1.9](mailto:grunt-cli@0.1.9)
├─┬ [findup-sync@0.1.2](mailto:findup-sync@0.1.2)
│ ├─┬ [glob@3.1.21](mailto:glob@3.1.21)
│ │ ├── [graceful-fs@1.2.3](mailto:graceful-fs@1.2.3)
│ │ ├── [inherits@1.0.0](mailto:inherits@1.0.0)
│ │ └─┬ [minimatch@0.2.12](mailto:minimatch@0.2.12)
│ │ ├── [lru-cache@2.3.0](mailto:lru-cache@2.3.0)
│ │ └── [sigmund@1.0.0](mailto:sigmund@1.0.0)
│ └── [lodash@1.0.1](mailto:lodash@1.0.1)
├─┬ [nopt@1.0.10](mailto:nopt@1.0.10)
│ └── [abbrev@1.0.4](mailto:abbrev@1.0.4)
└── [resolve@0.3.1](mailto:resolve@0.3.1)
輸出如下铝量,同樣倘屹,如果是要查看package
的全局安裝信息,加上-g
就可以
npm ls pkg
:查看特定package的信息
運(yùn)行如下命令慢叨,輸出grunt-cli
的信息
npm ls grunt-cli
輸出的信息比較有限纽匙,只有安裝目錄、版本拍谐,如下:
/private/tmp/npm
└── [grunt-cli@0.1.9](mailto:grunt-cli@0.1.9)
如果要查看更詳細(xì)信息烛缔,可以通過npm info pkg
,輸出的信息非常詳盡轩拨,包括作者践瓷、版本、依賴等亡蓉。
npm info grunt-cli
npm update pkg:package更新
npm update grunt-cli
npm search pgk:搜索
輸入如下命令
npm search grunt-cli
返回結(jié)果如下
npm http GET [http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838](http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838)
npm http 200 [http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838](http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838)
NAME DESCRIPTION AUTHOR DATE KEYWORDS
grunt-cli The grunt command line interface. =cowboy =tkellen 2013-07-27 02:24
grunt-cli-dev-exitprocess The grunt command line interface. =dnevnik 2013-03-11 16:19
grunt-client-compiler Grunt wrapper for client-compiler. =rubenv 2013-03-26 09:15 gruntplugin
grunt-clientside Generate clientside js code from CommonJS modules =jga 2012-11-07 01:20 gruntplugin
NPM發(fā)布
這個(gè)命令我自己也還沒實(shí)際用過晕翠,不誤導(dǎo)大家,語法如下砍濒,也可參考官方對于package發(fā)布的說明https://npmjs.org/doc/developers.html:
npm publish <tarball>
npm publish <folder>
NPM配置
npm
的配置工作主要是通過npm config
命令淋肾,主要包含增、刪梯影、改巫员、查幾個(gè)步驟,下面就以最為常用的proxy配置為例甲棍。
設(shè)置proxy
內(nèi)網(wǎng)使用npm
很頭痛的一個(gè)問題就是代理简识,假設(shè)我們的代理是 http://proxy.example.com:8080,那么命令如下:
npm config set proxy http://proxy.example.com:8080
由于npm config set
命令比較常用感猛,于是可以如下簡寫
npm set proxy http://proxy.example.com:8080
查看proxy
設(shè)置完七扰,我們查看下當(dāng)前代理設(shè)置
npm config get proxy
輸出如下:
http://proxy.example.com:8080/
同樣可如下簡寫:
npm get proxy
刪除proxy
代理不需要用到了,那刪了吧
npm delete proxy
查看所有配置
npm config list
直接修改配置文件
有時(shí)候覺得一條配置一條配置地修改有些麻煩陪白,就直接進(jìn)配置文件修改了
npm config edit
關(guān)于package.json
這貨在官網(wǎng)似乎沒有詳細(xì)的描述颈走,其實(shí)就是包的描述信息啦。假設(shè)當(dāng)我們下載了node應(yīng)用咱士,這個(gè)node應(yīng)用依賴于A立由、B、C三個(gè)包序厉,如果沒有package.json锐膜,我們需要人肉安裝這個(gè)三個(gè)包(如果對版本有特定要求就更悲劇了):
npm install A
npm install B
npm install C
有了package.json
,一行命令安裝所有依賴弛房。
npm install
package.json
字段簡介
字段相當(dāng)多道盏,但最重要的的是下面幾個(gè)
name: package
的名字(由于他會(huì)成為url的一部分,所以 non-url-safe 的字母不會(huì)通過,也不允許出現(xiàn)"."荷逞、"_")媒咳,最好先在http://registry.npmjs.org/上搜下你取的名字是否已經(jīng)存在
version: package
的版本,當(dāng)package
發(fā)生變化時(shí)种远,version
也應(yīng)該跟著一起變化涩澡,同時(shí),你聲明的版本需要通過semver
的校驗(yàn)(semver
可自行谷歌)
dependencies: package
的應(yīng)用依賴模塊院促,即別人要使用這個(gè)package
筏养,至少需要安裝哪些東東。應(yīng)用依賴模塊會(huì)安裝到當(dāng)前模塊的node_modules
目錄下常拓。
devDependencies
:package
的開發(fā)依賴模塊渐溶,即別人要在這個(gè)package
上進(jìn)行開發(fā)
其他:參見官網(wǎng)
package版本
在package.json
里,你經(jīng)常會(huì)在包名后看到類似"~0.1.0"
這樣的字符串弄抬,這就是包的版本啦茎辐。下面會(huì)列舉最常見的版本聲明形式,以及版本書寫的要求:
常見版本聲明形式
a掂恕、"~1.2.3"
是神馬意思呢拖陆,看下面領(lǐng)悟
"~1.2.3" = ">=1.2.3 <1.3.0"
"~1.2" = ">=1.2.0 <1.3.0"
"~1" = ">=1.0.0 <1.1.0"
b、"1.x.x"
是什么意思呢懊亡,繼續(xù)自行領(lǐng)悟
"1.2.x" = ">=1.2.0 <1.3.0"
"1.x.x" = ">=1.0.0 <2.0.0"
"1.2" = "1.2.x"
"1.x" = "1.x.x"
"1" = "1.x.x"
版本書寫要求
版本可以v
開頭依啰,比如 v1.0.1
(v
只是可選)
1.0.1-7
,這里的7
是所謂的“構(gòu)建版本號”店枣,不理是神馬速警,反正版本大于1.0.1
1.0.1beta
,或者1.0.1-beta
鸯两,如果1.0.1
后面不是 “連字符加數(shù)字” 這種形式闷旧,那么它是pre release
版本,即版本小于1.0.1
根據(jù)b钧唐、c忙灼,有:0.1.2-7 > 0.1.2-7-beta > 0.1.2-6 > 0.1.2 > 0.1.2beta
寫在后面
內(nèi)容只是簡單地把最常見的命令,以及一些需要了解的內(nèi)容列了出來钝侠。如要進(jìn)一步了解该园,可參考官網(wǎng)說明。此外:
npm help
是我們最好的朋友帅韧,如果忘了有哪些命令爬范,命令下有哪些參數(shù),可通過help進(jìn)行查看弱匪。