调试插件必须启动“扩展开发主机”窗口，VSCode插件不能在当前编辑器直接运行；所有断点和日志仅在此独立窗口生效，主窗口仅作控制台，修改代码后需保存并刷新该窗口才能生效。
调试插件必须启动“扩展开发主机”窗口
VSCode插件本身不能直接在当前编辑器里运行调试，你看到的任何断点或console.log输出，都只会在一个独立的“扩展开发主机”（Extension Development Host）窗口中生效。这个窗口是VSCode为你临时启动的、加载了你正在开发的插件的干净VSCode实例。不理解这一点，就容易误以为“断点没触发”或“日志没输出”。
实操建议：
- 按
F5启动调试时，VSCode 自动打开新窗口，所有插件逻辑都在其中运行；主窗口只是控制台，不执行你的插件代码 - 修改源码后，需手动保存 + 按
Ctrl+R（Windows/Linux）或Cmd+R（macOS）刷新扩展开发主机窗口，才能重新加载变更（热重载需额外配置watch模式） - 调试控制台（Debug Console）显示的是扩展开发主机窗口的输出，不是主窗口的终端
tasks.json 和 launch.json 必须协同工作
插件调试依赖两个关键配置文件：tasks.json 负责编译 TypeScript（如果你用 TS 开发），launch.json 负责启动调试会话并连接到扩展开发主机。只配其中一个，调试会卡在“正在启动”或报错 Cannot find module 'vscode'。
常见错误现象：
-
launch.json中preLaunchTask指向的 task 不存在 → 调试直接失败，提示 “Task not found” -
tasks.json的group没设为"build"或未标记"isDefault": true→F5不自动触发编译 - TypeScript 编译输出路径（
outDir）和launch.json中的program路径不一致 → 断点无法命中
示例关键片段（确保匹配）：
{
"version": "2.0.0",
"tasks": [{
"label": "build",
"type": "shell",
"command": "npm run compile",
"group": "build",
"isDefault": true,
"presentation": { "echo": false }
}]
}
{
"configurations": [{
"name": "Launch Extension",
"type": "extensionHost",
"request": "launch",
"runtimeExecutable": "${execPath}",
"args": ["--extensionDevelopmentPath=${workspaceFolder}"],
"outFiles": ["${workspaceFolder}/out/**/*.js"],
"preLaunchTask": "build"
}]
}
断点失效？先检查 node_modules 和 typescript 版本兼容性
VSCode 插件调试底层基于 Node.js 运行时，而 vscode 模块是通过 devDependencies 注入的模拟环境。如果项目中 typescript 版本过高（如 5.4+），但 @types/vscode 未同步更新，或 node_modules 存在多版本冲突，就会导致 sourcemap 错乱，断点显示为灰色、无法命中。
实操建议：
- 统一使用 VSCode 官方推荐的
@types/vscode版本（查看 API 文档底部 的兼容表） - 删除
node_modules和package-lock.json，用npm ci重装（比npm install更可靠） - 在
tsconfig.json中确认sourceMap和inlineSources均为true - 避免在
src/外写业务逻辑（比如放在test/下却没加进include）
调试时看不到变量值？别只盯 Debug Console
VSCode 插件运行在受限的扩展主机环境中，某些对象（如 vscode.window.activeTextEditor、vscode.workspace.workspaceFolders）在初始化阶段可能为 undefined，Debug Console 里直接打印会报错或显示空值。这不是代码问题，而是时机问题。
更可靠的观察方式：
- 在断点处把变量拖到“变量（Variables）”面板，展开看实时结构，比
console.log更准 - 右键变量 → “复制值” → 粘贴到普通终端里 JSON.parse 查看深层字段
- 对异步操作（如
vscode.workspace.findFiles），务必在await后设断点，否则看到的是 Promise 对象而非结果 - 使用
debugger;语句替代部分断点，它在运行时更稳定，尤其适合条件触发场景
复杂点在于：插件生命周期不可控——激活（activate）函数执行时机、命令注册顺序、UI 就绪状态，都会影响变量可访问性。很多“看不到值”的问题，本质是试图在错误的生命周期阶段读取未就绪的对象。
