vscode内置js-debug不提供内存快照图形化功能，仅暴露底层api；需手动在debug console执行v8.writeheapsnapshot()或借助chrome devtools分析。
为什么 vscode-js-debug 无法直接看到堆内存快照？
VSCode 默认的 Node.js 调试器（vscode-js-debug）不提供内存快照（heap snapshot）的图形化导出或对比功能——它只暴露了 Chrome DevTools Protocol 中的 HeapProfiler.takeHeapSnapshot 基础能力，但没封装成 UI 按钮。你点“暂停”“单步”很顺，但想查哪个 ArrayBuffer 占了 200MB，得手动调用 API 或切到浏览器 DevTools。
- 真正生成快照靠的是底层 V8 的
HeapProfiler模块，VSCode 只是中转请求 - 快照文件（
.heapsnapshot）默认存在临时目录，不会自动保存到项目里 - 如果你在 launch.json 里没配
"runtimeExecutable": "node"或用了nodemon，调试器可能根本连不上 V8 的调试端口，takeHeapSnapshot直接报Protocol error (HeapProfiler.takeHeapSnapshot): Not supported
怎样从 VSCode 触发并保存内存快照？
必须通过调试控制台（Debug Console）手动执行 JS 命令，不能依赖菜单。前提是：Node.js 版本 ≥ 12.0，且启动时启用了 inspect（VSCode 默认加了 --inspect-brk）。
- 在断点暂停后，打开 Debug Console，输入：
await new Promise(r => require('v8').getHeapSnapshot(r))—— 这会返回一个 ReadableStream，但 VSCode 控制台不支持流式下载 - 更实用的做法：运行时注入快照逻辑，比如在代码里加
require('v8').writeHeapSnapshot('./snapshot.heapsnapshot')，然后在终端里node --inspect your-app.js启动，再用 Chrome 访问chrome://inspect→ “Open dedicated DevTools for Node” → Memory 标签页 → “Take heap snapshot” - 如果坚持在 VSCode 内完成，可安装扩展
JavaScript Debugger (Nightly)（比内置调试器更新），然后在 Debug Console 执行：await new Promise(r => setTimeout(() => r(require('v8').writeHeapSnapshot('./snap-' + Date.now() + '.heapsnapshot')), 0))，注意路径需有写权限
process.memoryUsage() 和快照的区别在哪？
process.memoryUsage() 返回的是进程级粗粒度统计（heapTotal、heapUsed、external），适合监控趋势；而 heap snapshot 是对象图的完整序列化，能定位具体哪行 new Map() 持有了一千个闭包。两者不是替代关系，是配合使用。
-
heapUsed突增但heapTotal不涨？大概率是内存碎片或ArrayBuffer等 external 内存未被计入（看external字段） - 快照里搜
Retained Size最大的构造函数，90% 是泄漏源头；但要注意Closure类型对象常被误判为“大”，实际可能是正常作用域链 - 两次快照做对比（Comparison 视图）时，过滤条件选
Objects allocated between snapshots，别用Objects GCed between snapshots——后者显示的是已被回收的，对查泄漏无意义
为什么本地分析快照总卡死或打不开？
VSCode 自带的 .heapsnapshot 查看器只是个轻量预览，不支持解析 >200MB 的快照；真正分析必须用 Chrome DevTools 或 heapdump + ndb 这类工具。常见卡死原因不是文件损坏，而是加载策略问题。
- Chrome 打开大快照前，先在地址栏输入
chrome://flags/#enable-heap-snapshot-diffing启用实验特性，否则对比功能不可用 - 用
node --inspect --max-old-space-size=4096 app.js启动，避免 V8 因内存不足提前 abort 快照生成 - 快照文件若含中文路径或空格，
writeHeapSnapshot()可能静默失败，改用绝对路径并确保父目录存在：require('fs').mkdirSync('./snapshots', { recursive: true }); require('v8').writeHeapSnapshot('./snapshots/main.heapsnapshot');
快照本身不记录变量名和源码位置，只存对象引用关系。想精准归因，代码里得加有意义的 label 字符串（比如 const cache = new Map(); cache.label = 'userSessionCache';），不然所有 Map 在快照里长得一模一样。
