开启v8垃圾回收详细日志需组合--trace_gc --trace_gc_verbose --trace_gc_object_stats参数，可获取gc类型、耗时、各代堆内存变化、对象数量及external内存等完整信息，缺一不可。
怎么开启V8垃圾回收详细日志
直接加 --trace_gc 启动参数就能看到每次GC触发时的基础信息，但默认输出非常简略，只告诉你“Scavenge”或“Mark-sweep”，没堆内存变化、没耗时、没对象统计。真正要深度分析，得组合几个参数：
-
--trace_gc：必加，输出GC类型和时间戳 -
--trace_gc_verbose：显示每次GC前后heapTotal、heapUsed、rss的具体数值变化 -
--trace_gc_object_stats：V8 10.4+ 支持，输出各代空间（new_space、old_space）的对象数量与大小分布 -
--log_gc（已弃用）：旧版本可用，新版本会报错，别用
正确启动命令示例：node --trace_gc --trace_gc_verbose --trace_gc_object_stats index.js
日志里关键字段怎么看
典型输出中这几行最常被忽略但最关键：
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
-
[Heap] Scavenge (0x12345678) 123.4 ms：表示新生代GC耗时123.4毫秒，括号内是V8内部堆地址，调试时可配合内存快照比对 -
old_space: 12345678 bytes (12.3 MB) → 9876543 bytes (9.4 MB)：老生代GC后释放了约3MB，如果这个值长期不降，大概率有内存泄漏 -
new_space: survived 1234 objects (123 KB)：新生代GC后存活1234个对象，若该数字持续增长（尤其伴随promotion字样），说明对象过早晋升到老生代 -
external memory: 12345678 bytes：C++绑定（如Buffer、fs.readFile回调）占用的外部内存，不计入heapUsed，但会触发process.memoryUsage().external上涨
为什么process.memoryUsage()和GC日志对不上
这是最常被误解的一点：process.memoryUsage() 返回的是进程当前RSS和堆使用量快照，而GC日志记录的是V8引擎内部触发回收时的瞬时状态——两者采集时机不同，且RSS包含堆外内存（如代码段、线程栈、mmap分配的Buffer）。常见错觉：
- 调用
process.memoryUsage()返回heapUsed: 50MB，但日志里刚做完一次GC显示heapUsed: 30MB→ 实际是因为你调用时正好在两次GC之间，堆已增长但还没触发回收 - 日志显示
old_space降了10MB，但process.memoryUsage().rss没变 → RSS不会立刻返还给OS，V8默认保留释放的内存供后续分配复用 -
external值很高，但heapUsed很低 → 典型场景：大量fs.readFileSync()读取大文件生成Buffer，Buffer内存算external，不走JS堆
如何定位对象晋升异常
新生代对象本应“活不过两次GC”，但如果频繁看到日志里出现 promotion 或 evacuation 字样，且伴随 new_space 存活对象数稳定在高位（比如持续 >5000），说明对象正在被强制提前晋升。常见原因：
- 单次分配对象过大（>1KB），V8直接分配到老生代，绕过新生代 —— 查看
allocate_large_object日志条目 - 对象被闭包长期引用，比如事件监听器未移除、定时器未清理、全局缓存未设上限
- 使用
Buffer.allocUnsafe()后未及时.fill(0)，残留指针导致V8误判为活跃对象 - 频繁调用
JSON.parse()解析大JSON，解析中间对象容易晋升 —— 改用流式解析或分块处理
真正难的是区分“合理晋升”和“异常晋升”：老生代GC频率突然从每分钟1次变成每秒1次，同时 old_space 占用持续爬升，基本可以断定有泄漏源没被释放。
