Node.js/npm安装报错求助：node-sass编译失败问题

核心原因 #

node-sass已停止维护，且不支持Node.js 16以上版本（你当前使用的是Node.js 18.6.0），这是导致构建失败的根本原因。

解决方案 #

方案1：替换node-sass为官方推荐的sass（优先选择） #

这是长期稳定的解决方案，sass（dart-sass）是node-sass的官方替代，完全兼容Sass语法，且支持最新Node.js版本：

• 卸载旧依赖：

  npm uninstall node-sass
  

• 安装sass：

  npm install sass --save-dev
  

• 检查项目配置文件（如webpack、gulp、vue.config.js等），把所有引用node-sass的地方替换为sass，例如：

  // 旧代码
  const sassLoader = require('node-sass')
  // 新代码
  const sassLoader = require('sass')
  

方案2：降级Node.js版本（临时方案） #

如果暂时无法替换依赖，可降级到node-sass支持的Node.js 16.x LTS版本：

• 使用nvm管理Node版本（若未安装nvm，直接通过官方包安装Node.js 16.x即可）：

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

• 清理缓存并重新安装依赖：

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

方案3：修复系统构建依赖（辅助排查） #

若上述方案仍有问题，检查Linux系统是否具备node-gyp构建所需依赖：

• 安装build工具：

  sudo apt-get install build-essential
  

• 确保Python版本配置正确（日志显示已找到Python 3.8.10，可手动指定）：

  npm config set python python3.8
  

内容的提问来源于stack exchange，提问作者w.jelsma