Windows下react-scripts-ts配置max-old-space-size不生效致内存溢出

你看到的V8堆显示8G上限但2G就崩溃，核心原因有两个：

1. --max_old_space_size仅限制V8引擎的JavaScript老生代堆内存，不包含Node.js进程中C++侧占用的内存（比如TypeScript类型检查、sourcemap生成、文件IO缓冲区、原生Node模块占用的内存），这部分内存不受该参数限制。
2. 你查询V8堆统计的进程是webpack-dev-server的父进程，实际执行编译、占用内存的是fork出来的子进程，你拿到的父进程堆数据完全不反映真实内存占用，所以才会出现崩溃时used_heap_size仅5MB左右的反常数据。

• 先验证Node.js架构：Windows环境下32位Node.js单进程总内存上限默认就是2GB左右，无论怎么调整max_old_space_size都无法突破这个限制，执行node -p "process.arch"，返回x64才是64位版本，返回x86就是32位，这是该问题最高频的诱因。
• 验证环境变量透传：旧版react-scripts-ts依赖的webpack-dev-server会fork子进程执行编译任务，你在父进程shell临时设置的NODE_OPTIONS不一定能透传到子进程，会出现父进程堆配置生效、子进程还是默认内存上限的情况。
• 排查插件内存泄漏：react-scripts-ts内置的旧版fork-ts-checker-webpack-plugin、watch模式监听逻辑存在已知的内存泄漏问题，多次触发重编译时不会释放旧的编译产物缓存，内存会持续上涨。
• 排查sourcemap配置：开发环境如果开启了完整sourcemap，每次重编译都会生成大量sourcemap数据，这部分内存属于C++侧分配，不计入V8堆统计。

• 优先替换为64位Node.js 16.14.0版本，卸载当前32位版本后安装x64安装包，安装完成后重新执行node -p "process.arch"确认返回x64，绝大多数同类问题更换版本后直接解决。
• 不要在npm脚本里临时设置NODE_OPTIONS，直接在Windows系统环境变量里全局添加NODE_OPTIONS=--max_old_space_size=8192，用setx命令设置后重启终端，确保所有子进程都能读取到该参数，不要用cmd的set命令做临时配置，该配置仅对当前窗口父进程生效。
• 升级react-scripts-ts依赖的fork-ts-checker-webpack-plugin到兼容的最高版本，或者在tsconfig.json中关闭开发环境的实时类型检查，将类型检查任务放到构建阶段执行，大幅降低watch模式下的内存占用。
• 调整开发环境devtool配置为cheap-module-eval-source-map，不要使用完整的source-map模式，内存紧张时可以直接关闭开发环境sourcemap。
• 修改webpack watch配置，添加ignored: /node_modules/规则，避免监听node_modules目录下的文件变更触发无意义的重编译，旧版react-scripts-ts默认没有该忽略规则，长期运行会出现文件监听句柄泄漏导致内存上涨。
• 若以上方案都无法解决，建议将项目从无人维护的react-scripts-ts迁移到原生支持TypeScript的新版react-scripts，从3.0版本开始react-scripts已经内置TS支持，不存在旧版本的内存泄漏问题。临时缓解可以在触发3-4次重编译后手动重启dev server，避免内存累积到阈值崩溃。

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