安裝 node-sass 失敗原因及解決辦法匯總

node-sass 安裝過(guò)程

1. npm 拉下 node-sass包；
2. 根據(jù)node版本和node-sass版本拉取對(duì)應(yīng)的binding.node編譯器，原因是sass的編譯語(yǔ)言比較特殊，需要下載對(duì)應(yīng)版本的編譯器才能編譯；（node scripts/install.js 階段）
3. 如果能拉下binding.node就【安裝成功】； 如果找不到對(duì)應(yīng)的binding.node包，即失敗，然后就會(huì)嘗試本地編譯。

可能失敗的原因

一、網(wǎng)絡(luò)不穩(wěn)定

首先要知道的是，安裝 node-sass 時(shí)在 node scripts/install.js 這個(gè)階段會(huì)從 github.com 上下載一個(gè) .node 文件，大部分安裝不成功的原因都源自這里，因?yàn)?GitHub Releases 里的文件都托管在 s3.amazonaws.com 上面，而這個(gè)網(wǎng)址在國(guó)內(nèi)總是"網(wǎng)絡(luò)不穩(wěn)定"，所以我們需要通過(guò)第三方服務(wù)器下載這個(gè)文件。

解決辦法

1. 使用淘寶鏡像

npm set sass_binary_site http://cdn.npm.taobao.org/dist/node-sass

然后重新執(zhí)行 npm i node-sass 即可完成安裝。

2. 使用梯子

假設(shè)你的梯子在你本地機(jī)器上開(kāi)啟了一個(gè)第三方服務(wù)器 127.0.0.1:1080，那么只需按照下面的方法配置一下就能正常安裝 node-sass 了（如果你開(kāi)啟的是 PAC 模式而不是全局模式，那還需要將 s3.amazonaws.com 加入 PAC 列表）：

npm config set proxy http://127.0.0.1:1080
npm i node-sass

# 下載完成后刪除 http 代理
npm config delete proxy

3. 本地指定.node文件

比如我們?cè)诎惭b node-sass 的時(shí)候可以發(fā)現(xiàn)它需要下載具體版本對(duì)應(yīng)的 .node 文件:

$ npm install --save-dev node-sass
> node-sass@5.0.0 install D:\WorkSpace\node-sass-test\node_modules\gulp-sass\node_modules\node-sass
> node scripts/install.js

Downloading binary from http://npm.taobao.org/mirrors/node-sass/v5.0.0/win32-x64-72_binding.node

如果你的辦公環(huán)境不能訪問(wèn)外網(wǎng)，那么可以從有網(wǎng)絡(luò)的電腦上將.node文件（下載對(duì)應(yīng) node-sass 版本以及對(duì)應(yīng)操作系統(tǒng)的）下載過(guò)來(lái)，再傳到離線的電腦上指定 binary 路徑來(lái)安裝，執(zhí)行以下命令完成安裝：

npm i -D node-sass@5.0.0 --sass_binary_path=D:\files\win32-x64-72_binding.node

二、本地編譯沒(méi)有Python環(huán)境

方法1：通過(guò) NPM 包

網(wǎng)絡(luò)正常的情況下安裝 node-sass 是不需要Python環(huán)境的，如果拉不下來(lái)對(duì)應(yīng)的binding.node就會(huì)進(jìn)入嘗試【本地編譯】，然后會(huì)檢查是否具備的條件：需要python環(huán)境，報(bào)的錯(cuò)一般就會(huì)提示python沒(méi)有安裝（還是 Mac 香，自帶python環(huán)境沒(méi)有這些煩惱），安裝下面兩個(gè)包可以快速解決：

不過(guò)需要注意：拉包的方式需要cmd用管理員模式打開(kāi)! ! !

npm install -g node-gyp
npm install --global --production windows-build-tools

如果本地有網(wǎng)絡(luò)還好，這兩個(gè)包如果安裝成功了，node-sass 基本就能安裝成功了，但是如果你的辦公環(huán)境限制網(wǎng)絡(luò)可能也比較坑，參考：離線安裝 node-gyp 。

方法2：搭建Python環(huán)境（建議2.7）

• 1、去官網(wǎng)下載 www.python.org/download/re… ；
• 2、安裝成功之后，在環(huán)境變量中的系統(tǒng)變量新增python的安裝路徑；
• 3、執(zhí)行 npm rebuild node-sass 重構(gòu)一下；
• 4、再重新執(zhí)行 npm install node-sass

三、node-sass版本與當(dāng)前Node版本不匹配

因node版本與node-sass版本不匹配導(dǎo)致 binding.node 拉不下來(lái)，無(wú)法編譯。

node-sass 版本的兼容性不好，老項(xiàng)目中依賴的 node-sass 很可能已經(jīng)不兼容新的 node 版本，對(duì)應(yīng)版本兼容參考如下（或官方倉(cāng)庫(kù)）：

比如我在 Node 8 的環(huán)境下安裝 node-sass@3.13.1, 安裝的時(shí)候就會(huì)出現(xiàn)找不到對(duì)應(yīng)的 binding.node 而報(bào)錯(cuò)，如下：

$ npm install --save-dev node-sass
> node-sass@3.13.1 install D:\WorkSpace\mumble-next-ng\node_modules\gulp-sass\node_modules\node-sass
> node scripts/install.js

Downloading binary from http://npm.taobao.org/mirrors/node-sass/v3.13.1/win32-x64-57_binding.node
Cannot download "http://npm.taobao.org/mirrors/node-sass/v3.13.1/win32-x64-57_binding.node":

HTTP error 404 OK

出現(xiàn) 404 了，此時(shí)更換 node-sass 或 node 的版本即可。

具體參考方案：

npm i node-sass@4.8.3

因?yàn)镹ode 8 不能裝 node-sass 3.x 這是肯定的（Node 7才對(duì)應(yīng) 3.x），所以得裝 node-sass 4.x。

如果項(xiàng)目中還有 gulp-sass 之類的包，而 gulp-sass 2.x 里面用了 node-sass 3.x，還是會(huì)有坑，所以 gulp-sass 得換到 3.x，建議安裝 gulp-sass@3.2.1。

四、沒(méi)有清理緩存

每次裝包失敗報(bào)錯(cuò)后記得都要 npm uninstall xxx 清除裝包錯(cuò)誤留下的緩存。

比如 npm i -D node-sass 報(bào)錯(cuò)了，就要執(zhí)行一遍 npm uninstall node-sass，然后再重新安裝。