升级Node.js后无法解析依赖树，node-sass安装报错如何解决？

不需要降级Node.js，报错的核心原因有三个：一是项目依赖的node-sass早已官方弃用，和高版本Node适配性极差；二是当前使用的node-gyp@3.7.0版本过老，不兼容Node 16；三是Mac系统的Xcode命令行工具（CLT）状态异常，无法完成原生模块编译。你可以按照以下优先级选择方案解决：

方案1：替换node-sass为官方推荐的sass（最优解，从根源避免问题） #

node-sass已于2020年正式停止维护，不再适配Node 16及以上版本，官方推荐使用纯JS实现的sass（原dart-sass）作为替代，完全兼容现有scss语法，无需编译原生模块，无需修改业务代码：

• 卸载旧版node-sass

npm uninstall node-sass

• 安装sass

npm install sass --save-dev

• 完成后再执行npm audit fix即可正常运行。

方案2：保留node-sass的修复步骤 #

如果因项目历史原因无法替换node-sass，按以下步骤操作：

修复Xcode命令行工具异常 #

报错明确提示gyp: No Xcode or CLT version detected!，是现有CLT证书损坏导致，执行以下命令重置：

• 卸载损坏的CLT

sudo rm -rf /Library/Developer/CommandLineTools

• 重新安装CLT

xcode-select --install

按照弹窗提示完成安装后，执行xcode-select -p验证，正常会输出/Library/Developer/CommandLineTools。

升级node-gyp到兼容版本 #

当前使用的node-gyp@3.7.0是2018年发布的版本，不支持Node 16，全局升级到最新版：

npm install -g node-gyp@latest

安装适配Node16的node-sass版本 #

node-sass各版本和Node版本严格绑定，Node 16对应适配node-sass@6.0+版本，指定版本安装：

npm install node-sass@6.0.1 --save-dev

完成以上操作后再执行npm audit fix即可正常运行。

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