1. 程式人生 > >npm模塊安裝機制

npm模塊安裝機制

conf name 運行 lazy 檢查 ins 答案 16px offline

  npm 是 Node 的模塊管理器,功能極其強大。它是 Node 獲得成功的重要原因之一。正因為有了npm,我們只要一行命令:npm install,就能安裝別人寫好的模塊 。

一、從 npm install 說起

  npm install 命令用來安裝模塊到node_modules目錄。

$ npm install <packageName>

  安裝之前,npm install會先檢查,node_modules目錄之中是否已經存在指定模塊。如果存在,就不再重新安裝了,即使遠程倉庫已經有了一個新版本,也是如此。

  如果你希望,一個模塊不管是否安裝過,npm 都要強制重新安裝,可以使用 -f 或 --force 參數。

$ npm install <packageName> --force

二、npm update

  如果想更新已安裝模塊,就要用到npm update命令。

$ npm update <packageName>

  它會先到遠程倉庫查詢最新版本,然後查詢本地版本。如果本地版本不存在,或者遠程版本較新,就會安裝。

三、registry

  npm update命令怎麽知道每個模塊的最新版本呢?

  答案是 npm 模塊倉庫提供了一個查詢服務,叫做 registry 。以 npmjs.org 為例,它的查詢服務網址是 https://registry.npmjs.org/ 。這個網址後面跟上模塊名,就會得到一個 JSON 對象,裏面是該模塊所有版本的信息。比如,訪問 https://registry.npmjs.org/react ,就會看到 react 模塊所有版本的信息。它跟下面命令的效果是一樣的。

$ npm view react
 
# npm view 的別名
$ npm info react
$ npm show react
$ npm v react

  registry 網址的模塊名後面,還可以跟上版本號或者標簽,用來查詢某個具體版本的信息。比如, 訪問 https://registry.npmjs.org/react/v0.14.6 ,就可以看到 React 的 0.14.6 版。返回的 JSON 對象裏面,有一個dist.tarball屬性,是該版本壓縮包的網址。

dist: {
  shasum: 2a57c2cf8747b483759ad8de0fa47fb0c5cf5c6a
, tarball: http://registry.npmjs.org/react/-/react-0.14.6.tgz },

  到這個網址下載壓縮包,在本地解壓,就得到了模塊的源碼。npm install和npm update命令,都是通過這種方式安裝模塊的。

四、緩存目錄

  npm install或npm update命令,從 registry 下載壓縮包之後,都存放在本地的緩存目錄。

  這個緩存目錄,在 Linux 或 Mac 默認是用戶主目錄下的.npm目錄,在 Windows 默認是%AppData%/npm-cache。通過配置命令,可以查看這個目錄的具體位置。

$ npm config get cache
$HOME/.npm

  你最好瀏覽一下這個目錄。

$ ls ~/.npm
# 或者
$ npm cache ls

  你會看到裏面存放著大量的模塊,儲存結構是{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

  每個模塊的每個版本,都有一個自己的子目錄,裏面是代碼的壓縮包package.tgz文件,以及一個描述文件package/package.json。

  除此之外,還會生成一個{cache}/{hostname}/{path}/.cache.json文件。比如,從 npm 官方倉庫下載 react 模塊的時候,就會生成registry.npmjs.org/react/.cache.json文件。這個文件保存的是,所有版本的信息,以及該模塊最近修改的時間和最新一次請求時服務器返回的 ETag 。

$ rm -rf ~/.npm/*
# 或者
$ npm cache clean

五、模塊的安裝過程

  總結一下,Node模塊的安裝過程是這樣的。

  1、發出npm install命令

  2、npm 向 registry 查詢模塊壓縮包的網址

  3、下載壓縮包,存放在~/.npm目錄

  4、解壓壓縮包到當前項目的node_modules目錄

  註意,一個模塊安裝以後,本地其實保存了兩份。一份是~/.npm目錄下的壓縮包,另一份是node_modules目錄下解壓後的代碼。但是,運行npm install的時候,只會檢查node_modules目錄,而不會檢查~/.npm目錄。也就是說,如果一個模塊在~/.npm下有壓縮包,但是沒有安裝在node_modules目錄中,npm 依然會從遠程倉庫下載一次新的壓縮包。

  這種行為固然可以保證總是取得最新的代碼,但有時並不是我們想要的。最大的問題是,它會極大地影響安裝速度。即使某個模塊的壓縮包就在緩存目錄中,也要去遠程倉庫下載,這怎麽可能不慢呢?

  另外,有些場合沒有網絡(比如飛機上),但是你想安裝的模塊,明明就在緩存目錄之中,這時也無法安裝。

六、--cache-min 參數

  為了解決這些問題,npm 提供了一個--cache-min參數,用於從緩存目錄安裝模塊

  --cache-min參數指定一個時間(單位為分鐘),只有超過這個時間的模塊,才會從 registry 下載

$ npm install --cache-min 9999999 <package-name>

  上面命令指定,只有超過999999分鐘的模塊,才從 registry 下載。實際上就是指定,所有模塊都從緩存安裝,這樣就大大加快了下載速度。它還有另一種寫法。

$ npm install --cache-min Infinity <package-name>

  但是,這並不等於離線模式,這時仍然需要網絡連接。因為現在的--cache-min實現有一些問題。

  (1)如果指定模塊不在緩存目錄,那麽 npm 會連接 registry,下載最新版本。這沒有問題,但是如果指定模塊在緩存目錄之中,npm 也會連接 registry,發出指定模塊的 etag ,服務器返回狀態碼304,表示不需要重新下載壓縮包。

  (2)如果某個模塊已經在緩存之中,但是版本低於要求,npm會直接報錯,而不是去 registry 下載最新版本。npm 團隊知道存在這些問題,正在重寫 cache。並且,將來會提供一個--offline參數,使得 npm 可以在離線情況下使用。不過,這些改進沒有日程表。所以,當前使用--cache-min改進安裝速度,是有問題的。

七、離線安裝的解決方案

  社區已經為npm的離線使用,提出了幾種解決方案。它們可以大大加快模塊安裝的速度。解決方案大致分成三類。

  第一類,Registry 代理。

  • npm-proxy-cache

  • local-npm(用法)

  • npm-lazy

  上面三個模塊的用法很類似,都是在本機起一個 Registry 服務,所有npm install命令都要通過這個服務代理。

# 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

  有了本機的Registry服務,就能完全實現緩存安裝,可以實現離線使用。

  第二類,npm install替代。

  如果能夠改變npm install的行為,就能實現緩存安裝。npm-cache 工具就是這個思路。凡是使用npm install的地方,都可以使用npm-cache替代。

$ npm-cache install

  第三類,node_modules作為緩存目錄。

  這個方案的思路是,不使用.npm緩存,而是使用項目的node_modules目錄作為緩存。

  • Freight

  • npmbox

  上面兩個工具,都能將項目的node_modules目錄打成一個壓縮包,以後安裝的時候,就從這個壓縮包之中取出文件。

npm模塊安裝機制