global.gc() 是 node.js 中用于主动触发 v8 垃圾回收的调试工具，需通过 --expose-gc 启用，适用于基准测试中复位内存状态，但不可用于生产环境。
在 Node.js 性能基准测试中，global.gc() 是一种用于主动触发 V8 垃圾回收的手段，它能让内存状态更可控，从而减少 GC 不确定性对测试结果的干扰。但要注意：它不是生产环境推荐的操作，仅适用于调试、压测和精准内存行为分析场景。
启用 global.gc() 的必要前提
Node.js 默认不暴露 global.gc()，必须显式开启：
- 启动时添加
--expose-gc参数，例如：node --expose-gc benchmark.js - 若使用
ts-node或其他封装运行器，需确认参数透传，如：ts-node --expose-gc benchmark.ts - 未加该参数时调用
global.gc会报TypeError: global.gc is not a function
在基准测试中合理调用 gc() 的时机
盲目调用 global.gc() 可能扭曲真实性能表现。关键在于“复位”内存状态，而非频繁干预：
X-Node企业快速建站1.0.6.0801
下载
特色介绍： 1、ASP+XML+XSLT开发，代码、界面、样式全分离，可快速开发 2、支持语言包，支持多模板，ASP文件中无任何HTML or 中文 3、无限级分类，无限级菜单，自由排序 4、自定义版头（用于不规则页面） 5、自动查找无用的上传文件与空目录，并有回收站，可删除、还原、永久删除 6、增强的Cache管理，可单独管理单个Cache 7、以内存和XML做为Cache，兼顾性能与消耗 8、
- 每次测试用例执行前，先调用一次
global.gc()，确保堆从干净状态开始 - 测试结束后再调用一次，配合
process.memoryUsage()获取真实释放量 - 避免在循环内高频调用（如每轮迭代都 gc），否则会放大 GC 开销，掩盖业务逻辑耗时
- 可结合
--trace-gc验证是否生效：node --expose-gc --trace-gc benchmark.js，观察控制台输出的 GC 日志
一个轻量级基准测试模板示例
以下代码片段展示如何结构化使用 global.gc() 进行可控对比：
// benchmark.js
if (!global.gc) {
throw new Error('请使用 node --expose-gc 启动');
}
<p>function measure(fn) {
global.gc(); // 清空前一轮残留
const before = process.memoryUsage().heapUsed;</p><p>const start = performance.now();
const result = fn();
const end = performance.now();</p><p>global.gc(); // 强制回收临时对象
const after = process.memoryUsage().heapUsed;</p><p>return {
duration: end - start,
memoryDelta: after - before, // 理想应接近 0（若无泄漏）
result
};
}</p><p>// 示例：测试数组创建开销
const res = measure(() => Array(1e6).fill(0));
console.log(res); // { duration: 2.1, memoryDelta: 8012345 }
</p>
注意事项与常见陷阱
global.gc() 并不能保证立即完成全部回收，它只是向 V8 发出“尽快执行 GC”的信号：
- V8 可能仍按自身节奏分步执行（尤其老生代 Full GC），因此
memoryUsage().heapUsed不一定立刻下降 - 若测试中存在
Buffer、TypedArray或 C++ 插件分配的堆外内存，global.gc()对其无效——需额外监控external字段 - 在 CI 或容器环境中，某些安全策略可能禁用
--expose-gc，建议通过环境变量判断并降级处理 - 不要依赖
global.gc()解决内存泄漏；它只能辅助定位，真正的修复要靠消除强引用、清理定时器、关闭流等
