断点不生效是因为调试配置错误：必须用"type": "extensionHost"和"request": "launch"，断点设在activate函数或命令回调中，并确保sourceMap正确；普通node配置无法加载插件上下文。
VSCode插件调试中，断点不生效不是代码问题，而是调试配置和断点类型没对上——launch.json 必须用 extensionHost 类型，普通 node 配置无法加载插件上下文里的断点。
断点必须设在 extension.ts 或激活函数内
插件主入口（如 activate）是调试起点，断点设在未被调用的命令处理器或未注册的事件监听器里，永远不触发。常见错误包括：
- 在
deactivate里设断点但没手动触发卸载流程 - 在
registerCommand回调外层设断点，实际执行时已脱离插件宿主作用域 - 用
console.log测试发现能输出，但断点不中断——说明代码跑起来了，只是调试器没 attach 上
launch.json 的 type 和 request 必须匹配插件调试协议
VSCode 插件运行在独立的 Extension Host 进程中，不是普通 Node.js 进程。错配会导致断点图标变为空心红点（❌），且调试控制台无任何加载日志：
-
"type": "pwa-node"❌：只适用于独立脚本，无法访问vscodeAPI 实例 -
"type": "extensionHost"✅：唯一支持插件上下文的调试类型 -
"request": "launch"是默认值，但必须显式指定，否则某些旧版插件模板会 fallback 到错误模式 -
"runtimeExecutable"要指向当前 VSCode 可执行文件路径，例如 macOS 上为/Applications/Visual Studio Code.app/Contents/MacOS/Electron
条件断点在插件调试中要避开闭包变量和异步链
插件大量使用 vscode.commands.registerCommand、vscode.window.onDidChangeActiveTextEditor 等异步注册模式，条件断点表达式容易因作用域失效：
- 不能写
editor?.document.fileName === "test.js"——editor在断点行尚未声明，得改用vscode.window.activeTextEditor?.document.fileName === "test.js" - 在
then()回调里设条件断点，表达式里别直接引用外层let变量，优先用const或确保变量在 Promise 链中被正确捕获 - 避免在
setTimeout或setInterval内部写复杂条件，JS 调试器对定时器回调的上下文还原不稳定
Logpoint 比 console.log 更适合插件高频打点
插件启动后常有大量生命周期事件（如 onDidChangeConfiguration），用 console.log 容易污染终端且无法过滤；Logpoint 直接输出到调试控制台，支持变量插值且不暂停：
- 右键行号 →
Add Logpoint→ 输入Config changed: {vscode.workspace.getConfiguration().get("myExt.enable")} - 变量名必须完整路径，
{config}这种简写无效，因为 Logpoint 不共享执行上下文的局部变量 - 中文字符串可直接写，但插值花括号内仍需合法表达式，例如
用户操作: {e?.commandId || "unknown"}
插件调试最常被忽略的一点：每次修改 package.json 的 activationEvents 或 contributes 后，必须重启 Extension Development Host 窗口，否则新注册的命令根本不会被加载，断点自然失效。
