VSCode插件内存泄漏必然发生，主因是Extension Host不自动重置且未清理引用；需在deactivate()中显式dispose监听器、Webview、缓存及定时器等资源。
VSCode插件开发中，内存泄漏不是“可能出问题”，而是“不主动防御就必然发生”——因为Extension Host进程不会像浏览器那样刷新重置，所有未清理的引用都会持续累积。
onDidChangeTextDocument 未注销监听器是最常见泄漏源
注册监听却不配对清理，是插件里最典型的泄漏模式。VSCode 不会自动帮你卸载事件回调，只要监听器还挂在 document 上，整个 document 对象及其 AST、文本快照、装饰器等就无法被 GC。
- 必须在
deactivate()里调用disposable.dispose()，不能只靠 extension 关闭时隐式释放 - 避免直接用
vscode.workspace.onDidChangeTextDocument(cb)，改用context.subscriptions.push(...)统一管理生命周期 - 如果监听器里用了闭包捕获了
editor或document，检查是否在onDidCloseTextDocument中也做了对应清理 - 错误示例：
vscode.workspace.onDidChangeTextDocument(() => { /* 大量解析逻辑 */ });—— 没赋值给变量，根本没法 dispose
Webview 实例未销毁导致 Detached DOM 持续驻留
Webview 是插件里最易泄漏的模块之一。每次 webview.panel.webview.html = ... 都可能创建新上下文，但关闭面板后若没显式调用 panel.dispose() 或未清除 onDidReceiveMessage 回调，整个渲染树就卡在 Detached 状态。
- 务必在
panel.onDidDispose里清空所有消息监听：panel.webview.onDidReceiveMessage.off(handler) - 不要在 Webview 的 JS 里用全局变量缓存大对象（如图表数据、二进制 blob），它们脱离 DOM 后仍被闭包强持有
- 用 Chrome DevTools Memory 面板抓快照时，筛选
Detached DOM tree，若数量 > 0 且类型含HTMLDivElement或CanvasRenderingContext2D，基本就是 Webview 残留 - 调试时加一行：
console.log(`[Webview] ${panel.visible ? 'visible' : 'disposed'}`)，确认销毁时机是否准确
缓存未设限或未淘汰，Map 变成内存黑洞
插件里随手 new 一个 Map 存文档状态、AST、路径映射，看似无害，实则危险——没有 TTL、没有 LRU、没有最大条目数，几小时后就占几百 MB。
- 别用原生
Map做长期缓存；改用lru-cache并设置maxSize: 100和ttl: 5 * 60 * 1000 - 缓存 key 若含
TextDocument实例，注意它不可序列化且生命周期难控，优先用document.uri.toString()替代 - 在
deactivate()里显式调用cache.clear()，不要指望 GC 自动回收 - 加内存打点：
console.log(`[Cache] size=${cache.size}, heap=${(process.memoryUsage().heapUsed / 1024 / 1024).toFixed(1)} MB`)
动态 require 大型依赖引发模块级泄漏
在 activate() 里直接 require('acorn') 或 import('esprima')，会让整个模块及其依赖图常驻内存。V8 不会为插件做模块级 GC，require 过一次就永远在 require.cache 里。
- 改用
import()动态导入，且只在真正需要时触发（比如用户点击“格式化”按钮后） - 导入后若不再需要，可手动清理：
delete require.cache[require.resolve('acorn')]（注意仅对 CommonJS 有效） - 避免在闭包中长期持有解析器实例，例如把
acorn.parse结果缓存在顶层变量里 - 检查
node_modules是否被意外打包进插件发布包——webpack 配置漏掉externals会导致依赖重复加载
最隐蔽的泄漏往往不在你写的代码里，而在你没写的清理逻辑里：没 clear 的 setInterval、没 off 的 EventEmitter、没 dispose 的 StatusBarItem、没 release 的 FileSystemWatcher……这些都不会报错，只会让 Extension Host 的 RSS 内存一天比一天高，直到某次打开大文件，点击“运行”卡住三秒才被你发现。
