npm install执行失败，node-sass安装报错求助，常规方案无效

问题详情 #

执行npm install时因node-sass相关问题导致安装失败，核心报错信息如下：

gyp ERR! node -v v14.15.1
gyp ERR! node-gyp -v v7.1.2
gyp ERR! not ok 
Build failed with error code: 1
npm WARN @babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining@7.18.9 requires a peer of @babel/core@^7.13.0 but none is installed. You must install peer dependencies yourself.
npm WARN acorn-jsx@5.3.2 requires a peer of acorn@^6.0.0 || ^7.0.0 || ^8.0.0 but none is installed. You must install peer dependencies yourself.
npm WARN react-side-effect@1.2.0 requires a peer of react@^0.13.0 || ^0.14.0 || ^15.0.0 || ^16.0.0 but none is installed. You must install peer dependencies yourself.
npm WARN tsutils@3.21.0 requires a peer of typescript@>=2.8.0 || >= 3.2.0-dev || >= 3.3.0-dev || >= 3.4.0-dev || >= 3.5.0-dev || >= 3.6.0-dev || >= 3.6.0-beta || >= 3.7.0-dev || >= 3.7.0-beta but none is installed. You must install peer dependencies yourself.

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

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/snema4/.npm/_logs/2022-10-31T10_25_11_582Z-debug.log

已尝试删除package-lock.json、node_modules文件夹及卸载node-sass，但问题仍存在。

解决方案 #

1. 匹配node-sass与Node.js版本 #

node-sass@5.0.0官方兼容Node.js 12-14，但v5.0.0本身存在部分兼容性问题，推荐两种处理方式：

• 升级node-sass至同分支更稳定版本：

  npm uninstall node-sass
  npm install node-sass@5.2.1 --save-dev
  

• 直接替换为官方推荐的dart-sass（node-sass已停止维护）：

  npm uninstall node-sass
  npm install sass --save-dev
  

  替换后需确认项目中webpack等构建工具的loader配置，将node-sass相关引用改为sass配合sass-loader使用。

2. 修复node-gyp构建环境 #

node-gyp构建失败通常因缺少编译依赖，针对macOS系统：

• 安装Xcode命令行工具：

  xcode-select --install
  

• 配置npm使用正确的Python版本（node-gyp v7支持Python 3）：

  npm config set python /usr/bin/python3
  

• 清理缓存后重新安装：

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

3. 处理peer依赖警告 #

虽不直接导致安装失败，但解决后可避免运行时问题：

• 安装缺失的peer依赖（版本号可根据项目需求调整）：

  npm install @babel/core@^7.13.0 acorn@^8.5.0 react@^16.14.0 typescript@^3.9.7 --save-dev
  

内容的提问来源于stack exchange，提问作者Satyam