You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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运行内存,避免内存不足导致构建停滞。
  • 升级react-scripts版本:你当前使用的react-scripts@4.0.3存在已知的构建效率低、依赖处理卡顿的问题,可卸载当前版本后安装react-scripts@5.0.1版本,再执行构建命令。
  • 排查代码循环引用:如果以上方案都无效,可执行npx madge --circular src/检测项目中是否存在组件循环引用的情况,循环引用会导致构建进程卡死无法推进,修复对应循环引用后即可正常构建。

内容的提问来源于stack exchange,提问作者Nitesh Jha

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.23 16:36:02