--max-old-space-size本质是放宽V8老生代堆内存溢出阈值，仅影响长期存活对象区域，不改变新生代；需配合NODE_OPTIONS、package.json或cross-env设置，单位MB，数值须匹配物理内存并验证生效。
直接通过 --max-old-space-size 调整老生代内存上限，本质是告诉 V8 引擎“允许堆里最多存多少数据”，不是让 Node.js 主动多分配内存，而是放宽它触发内存溢出（FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory）的阈值。这个参数只影响老生代（Old Space），也就是存放长期存活对象的区域，对新生代（Scavenge 阶段）不生效。
为什么调这个值能缓解 GC 压力？
默认情况下，64 位 Node.js 进程的老生代上限约在 1.4–1.7 GB（不同版本略有浮动）。一旦堆中活跃对象接近该上限，V8 就会频繁执行全堆标记-清除（Mark-Sweep）或增量式 GC，导致卡顿甚至崩溃。拉高上限后，GC 触发频率下降，尤其适合处理大数组、长生命周期缓存、源码解析等场景——但前提是物理内存够用，且对象确实需要长期驻留。
三种可靠设置方式（按推荐顺序）
-
环境变量 NODE_OPTIONS（全局生效，推荐统一管控）
Linux/macOS：export NODE_OPTIONS="--max-old-space-size=6144"，建议写入~/.bashrc或~/.zshrc；Windows CMD：set NODE_OPTIONS=--max-old-space-size=6144，PowerShell：$env:NODE_OPTIONS="--max-old-space-size=6144" -
package.json scripts（前端项目最常用）
例如："dev": "node --max-old-space-size=6144 node_modules/.bin/vue-cli-service.js serve"。注意路径必须指向 .js 文件，不能是 shell wrapper（如vue-cli-service可能是无扩展名脚本，需换成对应 .js 路径） -
cross-env（跨平台 CI/CD 场景首选）
安装：npm install -D cross-env；使用："build": "cross-env NODE_OPTIONS=--max-old-space-size=8192 vue-cli-service build"
关键细节和避坑点
- 单位是 MB，不是 GB；写法必须是
--max-old-space-size（两个短横 + 英文连字符），--max_old_space_size（下划线）已废弃，会被忽略 - 数值不是越大越好：设到 8192 MB 以上时，单次 GC 停顿可能明显拉长；生产环境建议不超过物理内存的 60%，比如 16 GB 机器最多设 10240
- 低配机器（≤4 GB 总内存）慎用，超过 2048 容易触发系统 OOM Killer 杀死进程
- 设完必须验证：
node -e "console.log(require('v8').getHeapStatistics().heap_size_limit / 1024 / 1024)"输出值应与设定一致
搭配 PM2 或 systemd 时的额外控制
仅调 --max-old-space-size 不等于万无一失。建议叠加进程级兜底：
- PM2：配置
max_memory_restart: '4G'，当 RSS 内存超限时自动重启，避免泄漏累积 - systemd：在服务文件中同时设
Environment="NODE_OPTIONS=--max-old-space-size=4096"和MemoryMax=4G，防止 Node 进程吃光整机内存 - Docker：用
-m 4g限制容器内存，并在容器内同步设--max-old-space-size=4096，保持堆上限与 cgroup 限额一致
