VSCode插件主进程必须在Extension Development Host中调试，因vscode模块是主进程注入的全局API，仅在此环境有效；直接node运行会缺失上下文致报错，且activate由activationEvents触发，需手动执行注册命令才能命中断点。
VSCode插件的主进程（即 extension.ts 中的 activate 函数）不能像普通 Node.js 脚本那样直接用 node 运行调试——它必须在 VSCode 实例中被加载并触发，否则会报 Cannot find module 'vscode' 或 vscode is not defined。
为什么 attach 到主进程没反应？
很多人尝试用 launch.json 配置 type: "node" + program 指向 extension.ts，结果断点全灰、控制台无输出。这是因为：
-
vscode模块不是 npm 包，而是 VSCode 主进程注入的全局 API 对象，只存在于“扩展开发主机”窗口中 -
activate不是立即执行的函数，它由 VSCode 根据activationEvents触发（比如用户执行命令、打开特定文件等） - 直接
node extension.ts会缺失整个 VSCode 运行时上下文，vscode.window等全部为undefined
正确启动调试的三步闭环
必须走 VSCode 官方推荐的“Extension Development Host”流程，本质是启动一个干净的子 VSCode 实例来加载你的插件：
- 确保项目根目录下有
.vscode/launch.json，且包含标准的Launch Extension配置（type: "extensionHost"） - 按
F5启动后，VSCode 会自动拉起第二个窗口，标题栏显示Extension Development Host - 在这个新窗口里，必须触发一次激活事件：比如按下
Ctrl+Shift+P打开命令面板，输入你注册的命令名（如demo-vscode.helloWorld），回车执行
此时断点才会命中，console.log 输出出现在调试控制台（Ctrl+Shift+Y）而非终端。
常见断点失效场景与修复
即使流程正确，仍可能卡在“断点未绑定”。重点排查以下几点：
-
package.json中的main字段路径写错（比如写成./src/extension.js，但实际编译后是./out/extension.js） - tsconfig.json 编译目标不匹配：
target必须是ES2022或更高，且sourceMap为true，否则调试器找不到源码映射 - 插件未真正激活：检查
activationEvents是否过于宽泛（如*）或过于严格（如只响应onLanguage:python，但你打开的是.txt文件） - 修改代码后忘记重新编译：TS 文件变更不会自动转译，需手动运行
npm run compile或启用tsc -w监听模式
调试时最易忽略的上下文陷阱
主进程调试看似简单，但很多逻辑错误源于对运行时环境的误判：
-
vscode.workspace.rootPath在多根工作区中返回undefined，应改用vscode.workspace.workspaceFolders?.[0]?.uri.fsPath - 异步操作（如
vscode.workspace.findFiles）必须await，否则activate函数会提前返回，后续逻辑在无上下文环境中执行 - 所有注册资源（命令、事件监听器、WebviewPanel）必须显式调用
context.subscriptions.push()，否则调试重启多次后会累积多个监听器，行为不可预测
真正的难点不在“怎么启动调试”，而在于理解 activate 是一个受控入口——它不保证立即执行，也不保证单次执行，更不保证在你预期的文件上下文中执行。
