如何解决Node Sass安装时出现的npm gyp构建失败报错问题

报错原因 #

• node-sass 与 Node.js 存在严格的版本对应关系，Node 16.3.0 最低支持 node-sass@6.0.0 版本
• 低版本node-sass依赖的 node-gyp@3.8.0 不兼容 Node 16 环境，导致编译构建失败

解决方案 #

方案一：替换为dart-sass（优先推荐） #

node-sass官方已停止维护，dart-sass是官方指定的替代实现，无需本地编译，完全兼容原有sass语法，执行以下命令替换即可：

• 卸载旧版node-sass

npm uninstall node-sass

• 安装dart-sass

npm install sass --save-dev

项目中原有sass写法无需修改，可直接兼容。

方案二：安装匹配Node 16的node-sass版本 #

如果项目必须使用node-sass，直接安装对应兼容版本：

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

若仍出现gyp相关报错，先全局升级node-gyp到最新版本再重试：

npm install -g node-gyp@latest

方案三：切换Node版本适配旧版node-sass #

如果项目依赖的node-sass版本过低无法升级，可通过nvm切换到对应兼容的Node版本，例如node-sass@4.14.x对应Node 14环境。

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