node-sass 安装失败解决方案：镜像配置、版本匹配与构建工具修复

在前端依赖安装过程中，node-sass 常引发各类问题。经资料搜集与整理，本文提供一套经过两次实测验证的完整安装流程，供有需求的开发者参考执行。

本文假设读者的 Node.js 运行环境已具备基础配置，此处不再赘述环境搭建过程。

笔者测试环境使用的 Node.js 版本为 v14.16.0，读者可通过执行 node -v 命令确认自身 Node.js 版本。

1、配置国内淘宝镜像

npm 默认连接国外镜像源，下载速度往往较慢且易出错。为确保依赖包顺利下载，建议将镜像源切换至国内淘宝镜像。

npm config set registry https://registry.npm.taobao.org/

配置操作完成后，可运行 npm config get registry 命令检查配置是否已生效。

2、选择node-sass的版本

Node.js 版本与 node-sass 版本之间必须保持严格对应关系。

此步骤至关重要，若版本不匹配，将导致 node-sass 下载失败或引发其他未知错误。

鉴于笔者使用的 Node.js 版本为 14.16.0，因此选用 node-sass 4.14.1 版本。

关于更多版本间的对应关系，可参考 https://github.com/sass/node-sass 官方文档。

3、选择sass-loader的版本

node-sass 编译生成的结果需由 sass-loader 进行解析执行，因此二者版本同样需要相互匹配。

笔者在此处选择的 sass-loader 版本为 6.0.6。

另有观点认为 7.3.1 版本也可行，但笔者未对此进行测试，感兴趣的用户可自行尝试。

4、安装报错，缺少python环境

此类报错通常由缺少 Python 环境引起，因为 node-sass 依赖 Python 环境支持。可通过以下步骤解决：

4.1 删除工程的 node_modules 文件夹

4.2 以管理员身份打开命令提示符（dos窗口）

后续安装步骤需要管理员权限支持。

4.3 安装node-gyp

npm install -g node-gyp

4.4 安装windows-build-tools

此步骤同样需要管理员权限。

npm install --global --production windows-build-tools

在此过程中可能遇到以下问题：

1、下载速度缓慢

【解决】通常因 .NET Framework 版本过低导致，升级至对应版本即可解决（笔者使用的版本为 4.8）。下载地址：

https://dotnet.microsoft.com/download/visual-studio-sdks

查看具体版本的方法，后续将补充说明。

2、Visual Studio Build Tools 一直处于“Still waiting for installer log file…”状态

如下图所示

【解决】通常情况下 Python 下载较快，但 Visual Studio Build Tools 容易卡住不动。

此时无需等待，直接按 ctrl+c 停止进程，然后输入以下命令：

npm install --global --production windows-build-tools --vs2015

稍等片刻，即可安装成功。

特别注意

Python 安装完成后必须进行环境配置，需在系统 Path 变量中添加 Python 路径（该路径在 npm 下载 windows-build-tools 时会显示）。配置完成后，在 cmd 窗口执行 python --version 可查看版本信息以确认配置正确。

5、重新npm install即可

完成上述所有步骤后，再次执行安装命令，node-sass 即可成功安装。

以上仅为个人经验总结，旨在提供参考，欢迎大家支持本站。