node-sass是我们开发中很常见的依赖包，也是安装时间冗长和最常见到报错的依赖。 安装node-sass失败原因有很多种，我们在说失败原因之前，先来分析一下node-sass的安装过程(以下node版本为v10.15.3)：
PS D:\demo> npm i node-sass // 从npm源安装到node_modules > node-sass@4.13.0 install D:\demo\node_modules\node-sass > node scripts/install.js // 下载binding.node Downloading binary from https://github.com/sass/node-sass/releases/download/v4.13.0/win32-x64-64_binding.node Download complete .] - : Binary saved to D:\demo\node_modules\node-sass\vendor\win32-x64-64\binding.node // 缓存binding.node Caching binary to C:\Users\leepi\AppData\Roaming\npm-cache\node-sass\4.13.0\win32-x64-64_binding.node > node-sass@4.13.0 postinstall D:\demo\node_modules\node-sass > node scripts/build.js Binary found at D:\demo\node_modules\node-sass\vendor\win32-x64-64\binding.node Testing binary Binary is fine // 写package-lock.json npm notice created a lockfile as package-lock.json. You should commit this file. npm WARN demo@1.0.0 No description npm WARN demo@1.0.0 No repository field. + node-sass@4.13.0 added 174 packages from 138 contributors and audited 529 packages in 24.379s found 0 vulnerabilities
我们可以看到，安装node-sass有几个步骤：
- 校验本地node_modules中是否已安装node-sass，版本是否一致;
- 如未安装或版本不符，从npm源安装node-sass本体;
- 检测全局缓存和本地中是否有binding.node,如有即跳过安装;
- 没有binding.node则从github下载该二进制文件并将其缓存到全局;
- 假如binding.node下载失败，则尝试本地编译出该文件;
- 将版本信息写到package-lock.json;
由此看到，实际上node-sass依赖了一个二进制文件binding.node，从npm源安装完本体后还会从github下载binding.node。
因此安装node-sass相关的失败原因有以下几种：
因为网络限制原因，从国内安装官方源的依赖包会很慢。可以将npm源设置成国内镜像源(如淘宝npm)：
npm config set registry https://registry.npm.taobao.org
或者通过.npmrc文件设置:
// .npmrc registry=https://registry.npm.taobao.org/
node-sass除了npm部分的代码，还会下载二进制文件 binding.node，默认源是 github，国内访问较慢，有的线路会禁止访问。我们也可以将其改成国内源：
// linux、mac 下 SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/ npm install node-sass // window 下 set SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/ && npm install node-sass
或者通过 .npmrc 文件设置：
// .npmrc sass_binary_site=https://npm.taobao.org/mirrors/node-sass/
有类似问题的还有 chromedriver，phantomjs，electron 等常见依赖包，我们可以一并写到 .npmrc 中：
// .npmrc sass_binary_site=https://npm.taobao.org/mirrors/node-sass chromedriver_cdnurl=https://npm.taobao.org/mirrors/chromedriver phantomjs_cdnurl=https://npm.taobao.org/mirrors/phantomjs electron_mirror=https://npm.taobao.org/mirrors/electron
node-sass版本兼容性并不好，老项目中依赖的 node-sass 很可能已经不兼容新的 node，对应版本兼容如下(或参考官方仓库)：
| NodeJS | Supported node-sass version | Node Module |
|---|---|---|
| Node 17 | 7.0+ | 102 |
| Node 16 | 6.0+ | 93 |
| Node 15 | 5.0+, <7.0 | 88 |
| Node 14 | 4.14+ | 83 |
| Node 13 | 4.13+, <5.0 | 79 |
| Node 12 | 4.12+, <8.0 | 72 |
| Node 11 | 4.10+, <5.0 | 67 |
| Node 10 | 4.9+, <6.0 | 64 |
| Node 8 | 4.5.3+, <5.0 | 57 |
| Node <8 | <5.0 | <57 |
本文开头的安装例子中，binding.node的版本是v4.13.0/win32-x64-64_binding.node,可以看到，里面包括node-sass版本号v4.13.0,平台win32,架构x64,以及Node Module的版本64。Node Module是node的一个模块，其版本号可以在进程process.versions中查到：
PS D:\demo> node
> console.log(process.versions);
{ http_parser: '2.8.0',
node: '10.15.3',
v8: '6.8.275.32-node.51',
uv: '1.23.2',
zlib: '1.2.11',
ares: '1.15.0',
modules: '64',
nghttp2: '1.34.0',
napi: '3',
openssl: '1.1.0j',
icu: '62.1',
unicode: '11.0',
cldr: '33.1',
tz: '2018e' }
undefined
>
如上显示，node10.15.3对应的module版本为64。 假如node-sass与node的版本不兼容，就会找不到对应的binding.node而报错，例如你的node是10.15.3，装node-sass4.6.1，则会尝试安装v4.6.1/win32-x64-64_binding.node,但这个版本的binding.node是不存在的。 此时改node-sass或node的版本即可。
假如本地node版本改了，或在不同机器上运行，node版本不一致，会报类似错误：
Found bindings for the following environments: - Windows 64-bit with Node.js 6.x
这是因为原有binding.node缓存跟现node版本不一致。按提示npm rebuild node-sass或清除缓存重新安装即可。
安装失败后重新安装，有可能无权限删除已安装内容，此时npm uninstall node-sass或手动删掉原目录后再安装即可。
假如拉取binding.node失败，node-sass会尝试在本地编译binding.node，过程就需要python。假如你遇到前面几种情况解决了，实际上也不会出现在本地编译的情况了，我们就不谈这种失败中失败的情况吧 :-)
⚠️：此外相较原版有删改
原文标题：为什么node—sass总是安装失败？
原文链接：https://www.lipinghai.com/archivers/why-node-sass-always-fail-to-install
原文快照：为什么node—sass总是安装失败？
文章评论