React项目执行npm run build创建优化构建包时冻结无法完成问题求助
React项目npm run build卡住问题解决方案
- 处理依赖版本冲突:你的项目同时安装了Material UI v4(
@material-ui/*系列包)和Material UI v5(@mui/material),两个大版本共存会触发构建阶段的依赖解析死循环。请统一组件库版本,要么完全迁移到MUI v5并删除所有v4相关依赖,要么移除v5依赖只保留v4,调整后重新安装依赖再尝试构建。 - 调高Node进程内存上限:react-scripts默认分配的内存不足以支撑多依赖项目的生产构建,可修改package.json中的build脚本:
- Mac/Linux系统修改为:
"build": "NODE_OPTIONS=--max_old_space_size=8192 react-scripts build" - Windows系统修改为:
"build": "set NODE_OPTIONS=--max_old_space_size=8192 && react-scripts build"
上述配置会给构建进程分配8GB运行内存,避免内存不足导致构建停滞。
- Mac/Linux系统修改为:
- 升级react-scripts版本:你当前使用的react-scripts@4.0.3存在已知的构建效率低、依赖处理卡顿的问题,可卸载当前版本后安装react-scripts@5.0.1版本,再执行构建命令。
- 排查代码循环引用:如果以上方案都无效,可执行
npx madge --circular src/检测项目中是否存在组件循环引用的情况,循环引用会导致构建进程卡死无法推进,修复对应循环引用后即可正常构建。
内容的提问来源于stack exchange,提问作者Nitesh Jha
相关产品推荐
相关产品推荐

