使用Vue模板执行npm install时遇node-sass构建错误求助

问题重现 #

执行npm install时出现以下错误：

gyp ERR! build error
gyp ERR! stack Error: make failed with exit code: 2

npm ERR! node-sass@6.0.1 postinstall: node scripts/build.js
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the node-sass@6.0.1 postinstall script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

已尝试删除node_modules和package-lock.json重新安装，但问题依旧。

解决方案 #

1. 确认Node.js版本兼容性 #

node-sass@6.0.1仅支持Node.js 12.x-16.x版本。执行以下命令检查当前版本：

node -v

如果版本不在范围内，建议使用版本管理工具（如nvm）切换到兼容版本：

# 安装Node.js 16.x
nvm install 16
# 切换到该版本
nvm use 16

2. 安装编译依赖工具 #

make失败通常是因为缺少必要的编译环境：

• Linux（Ubuntu/Debian）：

  sudo apt-get update && sudo apt-get install build-essential
  

• macOS：

  xcode-select --install
  

• Windows：以管理员权限打开命令提示符，执行：

  npm install --global windows-build-tools
  

3. 使用国内镜像加速二进制包下载 #

node-sass的二进制包可能因网络问题下载失败，可临时或永久设置淘宝镜像：

• 临时安装：

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

• 永久配置：

  npm config set sass_binary_site https://npm.taobao.org/mirrors/node-sass/
  npm install
  

4. 替换为dart-sass（推荐） #

node-sass已停止维护，推荐使用dart-sass替代，兼容性更好且无需编译环境：

# 卸载node-sass
npm uninstall node-sass
# 安装dart-sass
npm install sass

若项目配置文件（如vue.config.js）中有引用node-sass的地方，将其改为sass即可。

内容的提问来源于stack exchange，提问作者Brandon Ruben González Ramirez