網絡原因導致 npm 軟件包 node-sass / gulp-sass 安裝失敗的處理辦法

如果你正在構建一個基於 gulp 的前端自動化開發環境，那么極有可能會用到 gulp-sass ,由於網絡原因你可能會安裝失敗，因為安裝過程中部分細節會到亞馬遜雲服務器上獲取文件。本文主要討論在不變更網絡環境的前提下安裝 gulp-sass / node-sass 。

問題描述

執行 npm install 安裝軟件包 gulp-sass

$ npm install gulp-sass

這個過程中會先安裝 node-sass ，因為 gulp-sass 依賴於 node-sass 。中間出現的錯誤信息類似下面這樣：

Cannot download https://github.com/sass/node-sass/releases/download/v3.4.2/win32-x64-46_binding.node

Hint: If github.com is not accessible in your location
try setting a proxy via HTTP_PROXY, e.g. 
export HTTP_PROXY=http://example.com:1234
or configure npm proxy via
npm config set proxy http://example.com:8080'

處理思路

看現象很有可能是這些二進制文件使用了 GitHub 的 lfs 服務，而 lfs 使用的是亞馬遜雲，由於網絡原因，這些服務器無法訪問。

現在解決問題的辦法思路就很清晰了，下載源碼自己編譯一個這樣的二進制文件，或下載官方的二進制文件。只要解決該文件的下載問題就可以繼續往后安裝。

打開 github 看一下該項目 https://github.com/sass/node-sass，在 releases 頁面能找到下失敗的文件 win32-x64-46_binding.node ，這里還可以下載到 source code，下載后里頭有 C++ 項目 使用 visualstudio2015 自己編譯一個就可以了。

同時，在 https://github.com/sass 下，還發現一個名字叫 node-sass-binaries 的項目，這里頭其實也有剛才的那個二進制文件，並且這里的是可以直接下載的（貌似沒使用 lfs）。

我不想自找麻煩，所以下面說一下直接使用該項目中的二進制文件進行安裝 node-sass 過程。

操作

npm 是一個功能超級強悍的工具，安裝一個軟件包的方式也當然不僅僅是 npm install packagename 這一種方式，當然這是最快捷的使用公共軟件包的安裝方式。

首先到官網（https://github.com/sass/node-sass/releases）下載 node-sass 項目源碼，下載后解壓至相應的 node_modules 目錄中。

接下來，打開 package.json 文件，檢查 script 字段

"scripts": {
    "coverage": "node scripts/coverage.js",
    "install": "node scripts/install.js",
    "postinstall": "node scripts/build.js",
    "pretest": "node_modules/.bin/jshint bin lib scripts test",
    "test": "node_modules/.bin/mocha test"
  },

打開 install 字段對應的文件 scripts/install.js，可以看到 checkAndDownloadBinary() 在下載這個二進制文件，URL使用的是 process.sass.binaryUrl，我們可以直接在這里覆蓋這個變量，把改地址修改為上面提到的那個能夠下載的二進制文件地址。

download(process.sass.binaryUrl, process.sass.binaryPath, function(err) {
    ....
}

或者，找出上面提到的 sass.binaryUrl() 方法，打開 ../lib/extensions.js 文件，大約108行左右，修改為如下樣子即可

function getBinaryUrl() {
  var site = flags['--sass-binary-site'] ||
             process.env.SASS_BINARY_SITE  ||
             process.env.npm_config_sass_binary_site ||
             (pkg.nodeSassConfig && pkg.nodeSassConfig.binarySite) ||
             'https://github.com/sass/node-sass/releases/download';

    //return [site, 'v' + pkg.version, sass.binaryName].join('/');
  return 'https://github.com/sass/node-sass-binaries/blob/master/win32-x64-46_binding.node';
}

重新安裝

進入node-sass 項目根目錄執行 install 命令：

$ cd node_modules/node-sass

$ npm install 

如果不出意外，這個安裝過程很快就會結束。

node-sass 安裝完成后，gulp-sass 的依賴問題也就解決了，然后跳出去 node_modules 目錄繼續安裝 gulp 。

$ cd ../..

npm install gulp-sass

 

寫在最后

關於本文如果您有任何建議或疑問請在下面留言交流。