CRA项目运行时TypeScript Server报堆内存溢出FATAL ERROR如何解决

该报错是CRA构建流程中，ForkTsCheckerWebpackPlugin 启动的独立子进程执行TypeScript类型检查、ESLint校验时触发内存溢出导致，并非TypeScript Server本身的bug。日志明确提示检查进程内存不足，CRA默认给该子进程分配的内存上限约2048MB，当项目代码量较大、类型定义复杂时很容易触顶崩溃。

• 调大检查进程内存上限
  未eject的CRA项目可通过craco、react-app-rewired等配置覆盖工具，修改ForkTsCheckerWebpackPlugin配置，添加memoryLimit: 4096（单位为MB，可根据项目大小调整到8192）。
  已eject的项目直接找到webpack配置中对应插件的初始化位置，添加上述memoryLimit参数即可。
  也可直接修改启动脚本给Node全局分配更大内存，package.json中脚本示例：

  // Mac/Linux
  "start": "NODE_OPTIONS=--max_old_space_size=4096 react-scripts start",
  // Windows 需先安装cross-env
  "start": "cross-env NODE_OPTIONS=--max_old_space_size=4096 react-scripts start"
  

• 缩小类型检查范围
  检查项目根目录tsconfig.json的include字段，不要将node_modules、构建产物目录、大型静态资源目录纳入检查范围，仅保留src下的业务代码路径，可大幅降低类型检查的内存消耗。
• 开发环境按需关闭实时检查
  本地调试阶段如果不需要实时类型/ESLint校验，可通过配置修改插件参数，开发环境下关闭插件的异步检查能力，需要校验时单独执行npx tsc --noEmit、npx eslint src做全量检查，可彻底规避启动阶段的内存溢出问题。
• 排查异常类型定义
  如果将内存上限调到8192MB仍报错，检查项目中是否存在递归自引用的类型定义、循环类型依赖，或是引入了体积异常大的第三方类型声明包，这类问题会导致TS类型推导时内存占用异常飙升。

赶进度无需改配置时，可直接多次重启开发服务，偶发的内存碎片回收完成后可临时启动成功，但该方案不稳定，不建议长期使用。

内容的提问来源于stack exchange，提问作者Elysee Bleu