在國內裝 npm 套件,最常遇到的就是卡住不動。淘寶(現在的 npmmirror)提供的鏡像就是為了解決這個問題而存在的——它是 npmjs.org 的完整鏡像,唯讀性質,定時與官方同步,延遲通常控制在一個很小的時間窗內。
需要補充的是,這個服務後來已更名為 npmmirror,網域也遷移到 npmmirror.com。網路上大量教學仍在引用舊網址,實際操作時建議以官方目前公布的網域為準。
cnpm 是官方 npm 的一個包裝,原生支援 gzip 傳輸,速度通常更好:
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
之後就可以用 cnpm install 取代 npm install。
alias cnpm="npm --registry=https://registry.npm.taobao.org \
--cache=$HOME/.npm/.cache/cnpm \
--disturl=https://dist.cnpmjs.org \
--userconfig=$HOME/.cnpmrc"
寫進 shell 設定檔才會每次開機都生效:
$ echo '\n#alias for cnpm\nalias cnpm="npm --registry=registry.npm.taobao.org \
--cache=$HOME/.npm/.cache/cnpm \
--disturl=https://dist.cnpmjs.org \
--userconfig=$HOME/.cnpmrc"' >> ~/.zshrc && source ~/.zshrc
bash 使用者把 .zshrc 換成 .bashrc 即可。
如果不想每次下指令都帶參數,最簡單的是改 npm 設定:
$ npm config set registry https://registry.npmmirror.com
$ npm config get registry # 驗證是否生效
鏡像有一個貼心的設計:當你要裝的模組還沒同步完成,它會在背景啟動同步,同時讓你這次先從官方源安裝。等你下次再裝同一個模組,就直接走鏡像了。
只有 cnpm 命令列工具支援 sync:
$ cnpm sync connect
也可以用網頁方式:
$ open https://npm.taobao.org/sync/connect
除了 publish 之外,npm 的指令 cnpm 幾乎都支援,寫法完全一致:
$ cnpm info connect
日常開發裡,把 registry 換掉這一步通常就能解決大半的安裝失敗問題。若是遇到 node-sass、puppeteer 這類需要下載二進位檔的套件,還要另外設定對應的 disturl 或環境變數,這點值得留意。