快捷導(dǎo)航

教你一招解決node-sass安裝各種坑

更新時(shí)間：2023年12月06日 10:12:36 作者：TPEngineer

這篇文章主要給大家介紹了關(guān)于如何通過一招解決node-sass安裝各種坑的相關(guān)資料,Node-sass是一個(gè)庫,它將Node.js綁定到LibSass(流行樣式表預(yù)處理器Sass的C版本),需要的朋友可以參考下

解決方法

node-sass 是 ruby 時(shí)代遺留下來的“寶貝”，依賴各種遠(yuǎn)古編譯環(huán)境，如 Python2.7、G++等，而現(xiàn)在我們?cè)偃パb會(huì)碰到各種報(bào)錯(cuò)。

實(shí)際上，我們用 sass 替代 node-sass 即可。dart-sass 兼容 node-sass 的 API，而且安裝過程無需下載二進(jìn)制文件，這樣大家就不需要安裝 node-sass 了。

package.json
{
    "sass": "^1.68.0",
}

編譯不會(huì)報(bào)錯(cuò)，但是會(huì)有一些過時(shí)寫法的警告。

Deprecation Warning: $weight: Passing a number without unit % (0) is deprecated.

To preserve current behavior: $weight * 1%

More info: https://sass-lang.com/d/function-units

   ?
42 │     color: mix($--tag-success-color, $--color-white, $fontColorWeight);

node-sass 安裝過程分析

首先了解一下 node-sass 安裝的過程：

npm 拉下 node-sass包；
根據(jù)node版本和node-sass版本拉取對(duì)應(yīng)的binding.node編譯器，原因是sass的編譯語言比較特殊，需要下載對(duì)應(yīng)版本的編譯器才能編譯；（node scripts/install.js 階段）
如果能拉下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)址在國內(nèi)總是"網(wǎng)絡(luò)不穩(wěn)定"，所以我們需要通過第三方服務(wù)器下載這個(gè)文件。

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

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

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

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

NodeJS	Supported node-sass version	Node Module
Node 15	5.0+	88
Node 14	4.14+	83
Node 13	4.13+, <5.0	79
Node 12	4.12+	72
Node 11	4.10+, <5.0	67
Node 10	4.9+	64
Node 8	4.5.3+, <5.0	57
Node <8	<5.0	<57

比如我在 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