执行npm install安装React项目时node-sass编译失败求助

问题本质 #

node-sass 在 Windows 环境下编译时依赖 Visual Studio 的 C++ 构建工具链，你的环境缺少必要的编译组件，导致编译流程中断。

分步解决方法 #

1. 安装必要的编译工具（无需完整安装Visual Studio） #

• 自动安装（推荐）：以管理员身份打开命令提示符，运行：

  npm install --global windows-build-tools
  

  该命令会自动安装 Python 2.7（node-sass@7.x 依赖版本）和 Visual C++ Build Tools 核心组件，安装过程需保持网络通畅，耗时可能较长。
• 手动安装：如果自动安装失败，直接通过 Visual Studio 安装器配置：
  1. 前往微软官网下载Visual Studio安装器
  2. 运行安装器后，选择「使用C的桌面开发」工作负载，务必勾选 **MSVC v142 - VS 2019 C x64/x86生成工具** 和 Windows 10 SDK 这两个核心组件，然后完成安装。

2. 配置npm指向正确的VS版本 #

安装完成后，执行命令指定npm使用的编译工具版本：

npm config set msvs_version 2019

node-sass@7.0.3 适配 VS2019 的构建工具，因此设置为2019。

3. 重新执行安装流程 #

清理现有依赖文件和缓存后重新安装：

rm -rf node_modules package-lock.json
npm cache clean --force
npm install

4. 跳过本地编译：使用预编译二进制包 #

如果上述方法仍无法解决，直接下载对应平台的预编译二进制包，绕开本地编译环节：
针对 Windows x64 环境，运行：

npm install node-sass@7.0.3 --sass_binary_site=https://npm.taobao.org/mirrors/node-sass/

该命令会从国内镜像获取已编译好的二进制文件，无需本地构建。

内容的提问来源于stack exchange，提问作者Rahil Əliyev