TypeScript开发VSCode扩展出现内存泄漏，如何调试？

基础准备 #

• 启动VSCode的开发调试模式，让扩展在扩展开发宿主窗口中运行。
• 在扩展开发宿主窗口按Ctrl+Shift+I（Windows/Linux）或Cmd+Opt+I（Mac）打开开发者工具。

内存快照分析 #

• 切换到开发者工具的Memory面板，选择Heap snapshot类型，点击Take snapshot获取初始内存快照。
• 重复触发扩展中可能引发泄漏的操作（比如反复打开/关闭自定义面板、执行核心命令），之后再拍1-2次快照。
• 对比快照：在快照列表里选后两个，切换到Comparison视图，重点关注数量持续增长的对象，尤其是和你扩展代码相关的类、函数实例。
• 查看Retainers面板，追踪对象的引用链路，定位到未被正确释放的引用源头。

常见泄漏场景排查 #

• 事件监听器未清理：检查你订阅的VSCode API事件（比如window.onDidChangeActiveTextEditor、workspace.onDidChangeConfiguration），确保在扩展停用或组件销毁时调用dispose()移除监听器。
• 全局变量滥用：别在全局作用域存大量实例或数据，尤其是组件实例、DOM元素，优先用局部作用域或WeakMap/WeakSet这类弱引用结构。
• VSCode资源未释放：创建的TextEditorDecorationType、StatusBarItem、WebviewPanel等资源，不用时必须调用它们的dispose()方法。
• 闭包意外引用：检查异步操作（比如setTimeout、Promise回调）里是否不小心保留了组件实例的引用，导致垃圾回收无法处理。

验证修复效果 #

• 修改代码后，重复之前的操作流程，再拍内存快照，确认可疑对象的数量不再持续上涨。
• 用开发者工具的Allocation Instrumenter功能，实时记录内存分配情况，监控是否还有异常的持续分配。

内容的提问来源于stack exchange，提问作者ajayg