vscode插件调试需配置正确的extensionhost启动项或手动附加，断点应设在activate()等懒加载处；多窗口需隔离user-data-dir和扩展路径；日志加进程前缀区分；热重载失败时需清理fs.watch等非disposable资源。
插件开发时调试窗口不响应 breakpoint
VSCode 插件本身运行在 Extension Host 进程里，而你启动的 Extension Development Host 窗口只是个“宿主壳子”——它不等于插件进程。你在主窗口打的断点，对插件代码完全无效。
真正有效的调试入口只有两个：launch.json 里配置的 type: "extensionHost" 启动项，或通过 Debug: Attach to Extension Host 命令手动连接。前者必须确保 "request": "launch" + "runtimeExecutable" 指向当前 VSCode 可执行路径（不是用户安装路径，而是开发环境里的那个）。
- Windows 下常见错误是
runtimeExecutable写成"C:\Users\xxx\AppData\Local\Programs\Microsoft VS Code\Code.exe"，但实际应为开发版路径，比如"${env:VS_CODE_DEV}\\Code.exe"（若用vscode-dev启动） - macOS 上若用
code --extensions-dir /tmp/ext启动，runtimeExecutable必须显式设为/Applications/Visual Studio Code.app/Contents/MacOS/Electron，否则调试器连不上 Extension Host - 断点要打在
activate()或命令注册回调里，而不是顶层模块代码——插件加载是懒触发的，没调用命令前根本不会执行
多个插件窗口互相干扰、状态错乱
VSCode 默认允许一个 Extension Host 进程服务多个开发窗口，但插件的全局变量、单例类、vscode.workspace.onDidChangeConfiguration 监听器会跨窗口共享。你改左窗配置，右窗的插件立刻收到通知，但此时右窗可能还没初始化完成，导致 undefined 报错。
解决办法不是禁用多窗口，而是强制每个开发窗口走独立 Extension Host：
- 在
launch.json中加"extensionDevelopmentPath"并确保每次启动都带唯一临时路径（如"${workspaceFolder}/dist-$(date +%s)"），避免缓存复用 - 启动命令改用
code --extension-development-path=${workspaceFolder} --disable-extensions --user-data-dir=/tmp/vscode-plugin-dev-$(date +%s)，关键在--user-data-dir隔离整个用户态环境 - 禁用
workbench.startupEditor: "none"，防止窗口启动时自动加载上一个工作区的插件上下文
调试控制台输出混杂、找不到自己插件的日志
所有插件共用同一个 DEBUG CONSOLE 输出流，且日志不带来源标识。你看到一行 console.log("init")，根本分不清是哪个窗口、哪个插件、甚至哪个线程打出来的。
最轻量的区分方式是主动加前缀：
- 在插件入口文件顶部加
const LOG_PREFIX = `[${process.pid}-${Date.now().toString(36)}]`;，所有console.log都拼上它 - 用
vscode.window.showInformationMessage(`${LOG_PREFIX} ready`)替代纯 console，消息弹窗天然绑定当前窗口上下文 - 避免用
console.error打调试信息——它会被捕获进PROBLEMS面板，和真实报错混在一起；改用vscode.window.setStatusBarItem动态更新状态栏文本，只对当前窗口可见
修改插件代码后热重载失败或卡死
VSCode 的插件热重载（Developer: Restart Extension Host）本质是杀掉旧进程再拉起新进程，但某些资源没释放干净：比如监听了 fs.watch 却没 .close()，或用了 setInterval 但没清除句柄，重启后新进程会和残留旧进程争抢端口/文件锁/IPC socket。
验证是否真重载成功，别只看控制台输出，直接查进程：
- Windows：任务管理器里搜
Code Helper (Renderer)，看 PID 是否变化 - macOS/Linux：终端跑
ps aux | grep "Extension Host"，对比前后 PID 和启动参数中的--user-data-dir - 在
deactivate()函数里补全清理逻辑：context.subscriptions.forEach(d => d.dispose())是基础，但还得手动关掉net.createServer、child_process.spawn、vscode.workspace.createFileSystemWatcher等非 Disposable 资源
热重载不可靠是常态，复杂插件建议直接关掉开发窗口再重新 F5 启动——省去猜哪段没清理干净的时间。
