material-kit-react.scss?v=1.8.0在Mac无法运行 Node Sass环境兼容问题求助
2026-9-24
解决方案
错误根因
你当前使用的Node版本为16+，而项目依赖的node-sass v4.14.1最高仅支持Node 14版本，版本不兼容导致构建失败。
方案1（优先推荐）：替换node-sass为官方维护的sass包
node-sass已正式停止维护，官方推荐迁移至dart-sass（即npm包名为sass的依赖），Creative Tim的组件库默认兼容该依赖，无需调整业务代码：
- 卸载旧版node-sass：
npm uninstall node-sass - 安装新版sass依赖：
npm install sass --save-dev - 清理缓存后重新构建即可：
npm run build
方案2：降级Node版本适配现有依赖
如果不想调整项目依赖配置，直接降级Node版本到兼容范围即可：
- 卸载当前Node版本，安装14.x的LTS版本，node-sass v4.14.1完美适配该Node版本
- 清理现有依赖文件后重新安装：
rm -rf node_modules package-lock.json yarn.lock npm install npm run build
方案3：升级node-sass版本适配高版本Node
如果必须使用16+版本的Node，可升级node-sass到对应兼容版本：
- Node 16对应node-sass v6.0+，执行命令：
npm install node-sass@6 --save-dev - Node 17及以上版本对应node-sass v7.0+，执行命令：
npm install node-sass@7 --save-dev - 注意升级后如果出现sass语法报错，对应调整项目中的scss语法规则即可
通用排查步骤
如果执行以上方案后仍报错，先清理npm缓存再重试：npm cache clean --force
内容的提问来源于stack exchange，提问作者Macilias
相关产品推荐
相关产品推荐
