[toc]
NPM 模塊安裝機(jī)制簡介
npm是Node的模塊管理器粒竖,功能很強(qiáng)大。它是Node獲得成功的原因之一籍琳。正因?yàn)橛辛薾pm先舷,我們只要一行命令 npm install
,就能安裝別人寫好的模塊前方。
參考文檔
從nam install說起
npm install
命令用來安裝模塊到node_modules
目錄狈醉。
$ npm install <packageName>
安裝之前,npm install
會(huì)先檢查惠险,node_modules
目錄之中是否已經(jīng)存在指定模塊苗傅。如果存在,就不再重新安裝了班巩,即使遠(yuǎn)程倉庫已經(jīng)有了一個(gè)新版本渣慕,也是如此。
如果你希望,一個(gè)模塊不管是否安裝過逊桦,npm 都要強(qiáng)制重新安裝眨猎,可以使用-f
或--force
參數(shù)。
$ npm install <packageName> --force
npm update
如果想更新已安裝模塊强经,就要用到npm update
命令睡陪。
$ npm update <packageName>
它會(huì)先到遠(yuǎn)程倉庫查詢最新版本,然后查詢本地版本匿情。如果本地版本不存在兰迫,或者遠(yuǎn)程版本較新,就會(huì)安裝码秉。
registry
npm update
命令怎么知道每個(gè)模塊的最新版本呢逮矛?
答案是 npm 模塊倉庫提供了一個(gè)查詢服務(wù),叫做 registry 转砖。以 npmjs.org 為例须鼎,它的查詢服務(wù)網(wǎng)址是 https://registry.npmjs.org/
。
這個(gè)網(wǎng)址后面跟上模塊名府蔗,就會(huì)得到一個(gè) JSON 對象晋控,里面是該模塊所有版本的信息。比如姓赤,訪問 https://registry.npmjs.org/react
赡译,就會(huì)看到 react 模塊所有版本的信息。
它跟下面命令的效果是一樣的不铆。
$ npm view react
# npm view 的別名
$ npm info react
$ npm show react
$ npm v react
registry 網(wǎng)址的模塊名后面蝌焚,還可以跟上版本號(hào)或者標(biāo)簽,用來查詢某個(gè)具體版本的信息誓斥。比如只洒, 訪問 https://registry.npmjs.org/react/v0.14.6 ,就可以看到 React 的 0.14.6 版劳坑。
返回的 JSON 對象里面毕谴,有一個(gè)dist.tarball
屬性,是該版本壓縮包的網(wǎng)址距芬。
dist: {
shasum: '2a57c2cf8747b483759ad8de0fa47fb0c5cf5c6a',
tarball: 'http://registry.npmjs.org/react/-/react-0.14.6.tgz'
},
到這個(gè)網(wǎng)址下載壓縮包涝开,在本地解壓,就得到了模塊的源碼框仔。npm install
和npm update
命令舀武,都是通過這種方式安裝模塊的。
緩存目錄
npm install
或npm update
命令离斩,從 registry 下載壓縮包之后银舱,都存放在本地的緩存目錄衷旅。
這個(gè)緩存目錄,在 Linux 或 Mac 默認(rèn)是用戶主目錄下的.npm
目錄纵朋,在 Windows 默認(rèn)是%AppData%/npm-cache
。通過配置命令茄袖,可以查看這個(gè)目錄的具體位置操软。
$ npm config get cache
$ /Users/gaolong/.npm
$ ls ~/.npm
# 或者
$ npm cache ls
你會(huì)看到里面存放著大量的模塊,儲(chǔ)存結(jié)構(gòu)是{cache}/{name}/{version}
宪祥。
$ npm cache ls react
~/.npm/react/react/0.14.6/
~/.npm/react/react/0.14.6/package.tgz
~/.npm/react/react/0.14.6/package/
~/.npm/react/react/0.14.6/package/package.json
每個(gè)模塊的每個(gè)版本聂薪,都有一個(gè)自己的子目錄,里面是代碼的壓縮包package.tgz
文件蝗羊,以及一個(gè)描述文件package/package.json
藏澳。
除此之外,還會(huì)生成一個(gè){cache}/{hostname}/{path}/.cache.json
文件耀找。比如翔悠,從 npm 官方倉庫下載 react 模塊的時(shí)候,就會(huì)生成registry.npmjs.org/react/.cache.json
文件野芒。
這個(gè)文件保存的是蓄愁,所有版本的信息,以及該模塊最近修改的時(shí)間和最新一次請求時(shí)服務(wù)器返回的 ETag 狞悲。
{
"time":{
"modified":"2016-01-06T23:52:45.571Z",
// ...
},
"_etag":"\"7S37I0775YLURCFIO8N85FO0F\""
}
對于一些不是很關(guān)鍵的操作(比如npm search
或npm view
)撮抓,npm會(huì)先查看.cache.json
里面的模塊最近更新時(shí)間,跟當(dāng)前時(shí)間的差距摇锋,是不是在可接受的范圍之內(nèi)丹拯。如果是的,就不再向遠(yuǎn)程倉庫發(fā)出請求荸恕,而是直接返回.cache.json
的數(shù)據(jù)乖酬。
.npm
目錄保存著大量文件,清空它的命令如下戚炫。
$ rm -rf ~/.npm/*
# 或者
$ npm cache clean
模塊的安裝過程
總結(jié)一下剑刑,Node模塊的安裝過程是這樣的。
1. 發(fā)出npm install命令
2. npm 向 registry 查詢模塊壓縮包的網(wǎng)址
3. 下載壓縮包双肤,存放在~/.npm目錄
4. 解壓壓縮包到當(dāng)前項(xiàng)目的node_modules目錄
注意施掏,一個(gè)模塊安裝以后,本地其實(shí)保存了兩份茅糜。一份是~/.npm
目錄下的壓縮包七芭,另一份是node_modules
目錄下解壓后的代碼。
但是蔑赘,運(yùn)行npm install
的時(shí)候狸驳,只會(huì)檢查node_modules
目錄预明,而不會(huì)檢查~/.npm
目錄。也就是說耙箍,如果一個(gè)模塊在~/.npm
下有壓縮包撰糠,但是沒有安裝在node_modules
目錄中,npm 依然會(huì)從遠(yuǎn)程倉庫下載一次新的壓縮包辩昆。
這種行為固然可以保證總是取得最新的代碼阅酪,但有時(shí)并不是我們想要的。最大的問題是汁针,它會(huì)極大地影響安裝速度术辐。即使某個(gè)模塊的壓縮包就在緩存目錄中,也要去遠(yuǎn)程倉庫下載施无,這怎么可能不慢呢辉词?
另外,有些場合沒有網(wǎng)絡(luò)(比如飛機(jī)上)猾骡,但是你想安裝的模塊瑞躺,明明就在緩存目錄之中,這時(shí)也無法安裝兴想。
—cache-min參數(shù)
為了解決這些問題隘蝎,npm 提供了一個(gè)--cache-min
參數(shù),用于從緩存目錄安裝模塊襟企。
--cache-min
參數(shù)指定一個(gè)時(shí)間(單位為分鐘)嘱么,只有超過這個(gè)時(shí)間的模塊,才會(huì)從 registry 下載顽悼。
$ npm install --cache-min 9999999 <package-name>
上面命令指定曼振,只有超過999999分鐘的模塊,才從 registry 下載蔚龙。實(shí)際上就是指定冰评,所有模塊都從緩存安裝,這樣就大大加快了下載速度木羹。
它還有另一種寫法:
$ npm install --cache-min Infinity <package-name>
但是甲雅,這并不等于離線模式,這時(shí)仍然需要網(wǎng)絡(luò)連接坑填。因?yàn)楝F(xiàn)在的--cache-min
實(shí)現(xiàn)有一些問題:
(1)如果指定模塊不在緩存目錄抛人,那么 npm 會(huì)連接 registry,下載最新版本脐瑰。這沒有問題妖枚,但是如果指定模塊在緩存目錄之中,npm 也會(huì)連接 registry苍在,發(fā)出指定模塊的 etag 绝页,服務(wù)器返回狀態(tài)碼304荠商,表示不需要重新下載壓縮包。
(2)如果某個(gè)模塊已經(jīng)在緩存之中续誉,但是版本低于要求莱没,npm會(huì)直接報(bào)錯(cuò),而不是去 registry 下載最新版本酷鸦。
npm 團(tuán)隊(duì)知道存在這些問題郊愧,正在重寫 cache。并且井佑,將來會(huì)提供一個(gè)--offline
參數(shù),使得 npm 可以在離線情況下使用眠寿。
不過躬翁,這些改進(jìn)沒有日程表。所以盯拱,當(dāng)前使用--cache-min
改進(jìn)安裝速度盒发,是有問題的。
離線安裝的解決方案
社區(qū)已經(jīng)為npm的離線使用狡逢,提出了幾種解決方案宁舰。它們可以大大加快模塊安裝的速度。
解決方案大致分成三類奢浑。
第一類蛮艰,Registry 代理:
npm-proxy-cache
local-npm(用法)
npm-lazy
上面三個(gè)模塊的用法很類似,都是在本機(jī)起一個(gè) Registry 服務(wù)雀彼,所有npm install
命令都要通過這個(gè)服務(wù)代理壤蚜。
# npm-proxy-cache
$ npm --proxy http://localhost:8080 \
--https-proxy http://localhost:8080 \
--strict-ssl false \
install
# local-npm
$ npm set registry http://127.0.0.1:5080
# npm-lazy
$ npm --registry http://localhost:8080/ install socket.io
有了本機(jī)的Registry服務(wù),就能完全實(shí)現(xiàn)緩存安裝徊哑,可以實(shí)現(xiàn)離線使用袜刷。
第二類,nom-cache install替代莺丑。
如果能夠改變npm install
的行為著蟹,就能實(shí)現(xiàn)緩存安裝。npm-cache
工具就是這個(gè)思路梢莽。凡是使用npm install
的地方萧豆,都可以使用npm-cache
替代。
$ npm-cache install
第三類昏名,node_modules作為緩存目錄炕横。
這個(gè)方案的思路是,不使用.npm
緩存葡粒,而是使用項(xiàng)目的node_modules
目錄作為緩存份殿。
Freight
npmbox
上面兩個(gè)工具膜钓,都能將項(xiàng)目的node_modules
目錄打成一個(gè)壓縮包,以后安裝的時(shí)候卿嘲,就從這個(gè)壓縮包之中取出文件颂斜。
npm -g 全局安裝包
npm -g 代表全局安裝
# 全局安裝webpack
$ npm -g webpack
#查看全局安裝的包
$ npm list -g > Desktop/npm_g_list.txt
$ 全局包安裝的目錄路徑
$ /Users/gl/.nvm/versions/node/v8.11.1/lib