命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
写入堆快照和内存分解以诊断高内存使用
/heapdump 是 Claude Code 的内置诊断 slash 命令，用于将当前进程的 JavaScript 堆快照和内存分解报告写入磁盘。它不与模型交互，纯粹是本地 Node.js 进程层面的内存诊断工具（据 heapsnapshot 的性质推断，非官方明文）。
官方文档将其定位为高内存占用时的"最后一步排查手段"——在常规缓解步骤（/compact、重启、--safe-mode）都无法降低内存后再运行。
在任意 Claude Code 会话内输入：
/heapdump
无参数，无选项。命令执行后，向磁盘写入两个文件：
| 文件 | 用途 |
|---|---|
*.heapsnapshot | V8 堆快照，可在 Chrome DevTools 中打开 |
| 内存分解文本 | 包含 RSS、JS Heap、Array Buffers、Native 内存的数字明细 |
输出目录：
~/Desktop/~/（家目录）.heapsnapshot按官方文档：在 Chrome DevTools 的 Memory 面板中通过 Load 载入 .heapsnapshot 文件（"open the .heapsnapshot file in Chrome DevTools under Memory → Load"），即可查看对象与引用关系、定位内存持有者。
/compact 和重启均无效后，执行 /heapdump 获取进程内存快照，区分是 JS 对象泄漏还是 native 内存增长。.heapsnapshot 和内存分解文件两份，以便开发者复现和定位。C:\Users\<user>\Desktop 目录，但如果该目录已存在，Node.js 的 mkdir 调用会抛出 EEXIST: file already exists 错误，导致命令完全失败。该问题已在 GitHub issue #32690 中被记录并标记为 duplicate（即已有重复 issue，但截至 2026-06-14 尚无公开的 workaround 写入该 issue 中）。~/Desktop。若桌面被云盘同步接管，实际落盘位置可能与 Finder 中所见不一致，找不到时优先用文件名在全盘搜索 .heapsnapshot。/heapdump 的完整使用说明及上下文步骤修复了Windows上EEXIST错误的问题