You need to enable JavaScript to run this app. create-react-app建React项目node-sass不兼容,装4.14.1版仍报错
优惠活动
大模型
产品
解决方案
定价
更多

create-react-app建React项目node-sass不兼容,装4.14.1版仍报错

问题场景
  • 通过npm create-react-app初始化的React项目,初始安装依赖包含react ^17.0.1、node-sass ^5.0.0
  • 在index.js中引入空白index.scss文件时,本地运行抛出版本不兼容报错:Node Sass version 5.0.0 is incompatible with ^4.0.0
  • 执行npm uninstall node-sass卸载旧版本后,通过npm install node-sass@4.14.1安装适配版本,操作完成后仍弹出完全相同的报错,无任何变化
  • 全流程可通过项目内index.js代码、本地页面报错、终端npm命令执行结果的截图追溯
可落地的排查解决操作
  • 清理残留依赖文件
    • 删除项目根目录下的node_modules文件夹、package-lock.json文件
    • 执行npm cache clean --force清除本地npm缓存
    • 重新执行npm install拉取全量依赖后启动项目
  • 核对锁文件版本残留
    检查package.json、package-lock.json中是否仍留存node-sass@5.x的版本锁定记录,手动修正为4.14.1后重新安装依赖
  • 校验Node版本适配关系
    node-sass@4.14.1仅兼容Node.js 14及以下版本,若本地Node版本超出适配范围,需切换至对应适配版本后再启动项目
  • 无兼容版本适配时的替代方案
    彻底卸载原有node-sass依赖后,安装CRA内置加载器可识别的Dart Sass版本:
    • 执行命令:
      npm uninstall node-sass
      npm install sass@1.32.0
      
    该方案无需修改项目内原有SCSS文件的引入逻辑,即可正常编译样式文件

内容的提问来源于stack exchange,提问作者Nikhil Aggarwal

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 11:24:08