安装SCSS后React项目本地服务无法启动是什么原因,如何解决?
问题排查与解决方案
第一步:修复react-scripts: command not found报错
出现该报错的直接原因是你删除node_modules后未重新安装项目依赖,先执行以下操作:
- 执行依赖安装命令:
npm install - 安装完成后先尝试启动服务:
npm start
如果启动后没有SCSS相关报错,可直接正常使用;如果仍有兼容报错,继续执行下一步操作。
第二步:替换已废弃的node-sass解决SCSS兼容问题
node-sass官方已停止维护,和Node版本强绑定极易出现兼容问题,目前React生态统一推荐使用dart-sass(npm包名为sass)替代,完全兼容原有SCSS语法无需修改业务代码:
- 先卸载旧的node-sass包:
npm uninstall node-sass
- 清理残留文件与缓存(注意你此前删除的
npm.lock文件名错误,正确的锁文件名为package-lock.json):
rm -rf node_modules package-lock.json npm cache clean --force
- 重新安装所有基础依赖:
npm install
- 安装兼容版SCSS工具包:
npm install sass --save-dev
- 启动服务测试:
npm start
极端情况兜底处理
如果执行上述操作后仍然提示react-scripts不存在,说明你的package.json中丢失了该依赖,手动安装即可:
npm install react-scripts --save
内容的提问来源于stack exchange,提问作者Aaron Serpilin
相关产品推荐
相关产品推荐

