VS Code插件调试不生效主因是launch.json中runtimeExecutable路径错误或缺失--extensionDevelopmentPath参数，导致Extension Development Host无法加载插件代码，断点不触发、控制台仅显示“Extension activated”即结束。
调试插件时 launch.json 配置不生效
常见现象是按 F5 启动调试后，直接报错 Cannot find module 'vscode' 或弹出空白 Extension Development Host 窗口，根本没加载你的插件代码。
根本原因不是路径写错，而是 launch.json 里 runtimeExecutable 指向了错误的 VS Code 可执行文件，或者 args 缺少 --extensionDevelopmentPath 参数。
- 确保
runtimeExecutable指向你本地安装的 VS Code 主程序（Windows 是Code.exe，macOS 是/Applications/Visual Studio Code.app/Contents/MacOS/Electron，Linux 是code命令所在路径） -
args必须包含"--extensionDevelopmentPath=${workspaceFolder}"，否则调试 host 不知道该加载哪个扩展 - 如果用的是 Insiders 版本，
runtimeExecutable必须对应Code - Insiders.exe或其 macOS/Linux 路径，混用会导致插件不激活
断点不命中、调试器连接失败
在 activate 函数或命令回调里打的断点完全不触发，控制台只输出 Extension activated 就结束 —— 这说明调试器没挂载到 Extension Development Host 进程上。
VS Code 插件调试本质是「双进程」：一个 host 进程加载你的插件，一个调试器进程 attach 到它。任何一环断开都会导致断点失效。
- 检查
launch.json中port是否被其他进程占用（默认 9229），可改用9230等空闲端口 - 确认
outFiles路径匹配实际生成的 JS 文件位置（比如"./out/**/*.js"），否则 source map 找不到源码 - 若使用 TypeScript，必须开启
sourceMap: true且编译后保留.map文件，否则断点只会停在 JS 行，无法跳转回 TS
中文日志乱码或调试控制台显示异常字符
在 console.log('初始化完成') 中文输出变成 或方块，或调试控制台里堆栈信息夹杂乱码 —— 这不是插件问题，而是 Node.js 运行时环境编码未统一。
VS Code 的 Extension Development Host 基于 Electron，底层 Node.js 默认使用系统 locale 编码。Windows 中文系统常为 GBK，而 VS Code 内部和大多数插件假设 UTF-8。
- 在
launch.json的env字段中强制设置："env": {"NODE_OPTIONS": "--no-warnings", "PYTHONIOENCODING": "utf-8"} - Windows 用户额外加一条：
"env": {"CHCP": "65001"}（即chcp 65001命令，切换当前终端为 UTF-8） - 避免在插件代码里用
fs.readFileSync读取含中文的 JSON 或配置文件时不指定编码，一律显式传{ encoding: 'utf8' }
调试时内存泄漏难定位
插件运行几分钟后响应变慢、CPU 占用飙升，但常规断点和 console 输出看不出问题 —— 很可能是事件监听器未清理、全局变量持续累积或 TextDocument / TextEditor 引用未释放。
VS Code 插件生命周期管理比普通 Node 应用更敏感，deactivate 钩子不一定被调用，不能依赖它做清理。
- 所有
context.subscriptions.push(...)注册的 Disposable 对象，必须确保只 push 一次，重复注册会累积监听器 - 监听
vscode.workspace.onDidOpenTextDocument时，务必用document.isClosed判断再处理，否则已关闭文档仍被反复触发 - 用
vscode.window.onDidChangeActiveTextEditor获取 editor 时，先判空再访问editor.document，防止 null reference
真正棘手的是异步任务未 cancel 导致的隐性引用，比如 setTimeout 或 fetch 请求返回后更新 UI，但插件已禁用 —— 这类问题只能靠 vscode-test + mock 环境复现，线上调试几乎不可见。
