Laravel 5.6安装npm依赖失败 node-sass构建错误如何解决

报错核心是版本不兼容：

• Laravel 5.6默认依赖的node-sass@4.x最高仅支持Node.js 14及以下版本，你当前使用的Node.js v16.16.0不在兼容范围内
• 依赖链里自带的node-gyp v3.8.0版本过旧，无法适配Node16的原生模块编译接口，直接导致构建失败

方案1：切换Node到兼容版本（最稳定，零依赖改动，优先选） #

老项目优先用版本匹配的运行环境，不要随意升依赖避免后续连锁兼容问题：

• 先清理项目残留依赖和缓存，在项目根目录执行命令：

:: 删除已安装的依赖和锁文件
rd /s /q node_modules
del package-lock.json
:: 清空npm缓存
npm cache clean --force

• 将本地Node版本切换到14.x（推荐14.21.3，是14系列最终稳定版）：如果用nvm-windows管理Node版本，直接执行nvm install 14.21.3 && nvm use 14.21.3即可；没有装版本管理工具就直接卸载当前Node16，下载Node14.x安装包重装。
• 重新执行npm install即可正常完成安装，后续npm run dev/npm run prod编译流程不会有兼容问题。

方案2：替换node-sass为dart-sass（不想降Node版本可选） #

node-sass已经官方废弃，现在推荐使用纯JS实现的sass（即dart-sass），不需要本地编译原生模块，从根源上避免node-gyp相关报错：

• 同样先清理残留依赖，执行方案1里的清理命令
• 移除旧的node-sass依赖，安装兼容老版laravel-mix的sass版本：

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

注意不要安装高于1.32.x的sass版本，否则会和Laravel5.6自带的laravel-mix@2.x出现API兼容报错

• 无需修改webpack.mix.js里的原有sass配置，直接执行npm install即可完成安装，后续编译命令和之前完全一致。

方案3：保留Node16+node-sass组合（不推荐，后续易出问题） #

如果因为特殊原因必须保留node-sass，需要手动补全编译环境、升级对应依赖：

• 全局升级node-gyp到最新版：npm install -g node-gyp@latest
• 管理员身份打开命令行，执行npm install -g windows-build-tools，自动安装Python2.7、VS C++编译工具等node-gyp必需的依赖
• 将项目内的node-sass升级到支持Node16的v6.0.1版本：npm install node-sass@6.0.1 --save-dev
• 清理缓存后重新执行npm install

• 安装时如果出现路径相关报错，把项目从桌面移动到非系统盘的纯英文路径下，避免Windows系统目录权限限制、中文路径识别异常问题
• 不要加--ignore-scripts参数跳过node-sass编译步骤，否则后续运行编译命令时会出现二进制包不匹配的运行时错误

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