DIV CSS 佈局教程網

淘寶 NPM 鏡像教學:如何把 npm 下載源換成國內鏡像
編輯:JavaScript基礎知識     

在國內裝 npm 套件,最常遇到的就是卡住不動。淘寶(現在的 npmmirror)提供的鏡像就是為了解決這個問題而存在的——它是 npmjs.org 的完整鏡像,唯讀性質,定時與官方同步,延遲通常控制在一個很小的時間窗內。

鏡像的基本情況

  • registry 從 npmjs.org 做全量同步。
  • 服務本身由開源的 cnpmjs.org 專案驅動。
  • 運行在 Node.js 環境之上。

需要補充的是,這個服務後來已更名為 npmmirror,網域也遷移到 npmmirror.com。網路上大量教學仍在引用舊網址,實際操作時建議以官方目前公布的網域為準。

方式一:安裝 cnpm 命令列工具

cnpm 是官方 npm 的一個包裝,原生支援 gzip 傳輸,速度通常更好:

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

之後就可以用 cnpm install 取代 npm install。

方式二:設定 alias

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 或環境變數,這點值得留意。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved