VSCode插件入口是extension.ts的activate函数，需满足activationEvents条件才触发；确认方法：打开Extension Development Host的DevTools（Ctrl+Shift+I），执行对应命令（如Ctrl+Shift+P输入命令名），检查控制台输出及断点是否命中。
调试插件时 extension.ts 不触发，怎么确认入口是否加载？
VSCode 插件的执行起点是 extension.ts 中的 activate 函数，但它不会在安装后自动运行，而是在满足“激活事件”条件时才被调用。常见误解是改完代码就按 F5，却发现断点不命中、console.log 没输出——大概率是没触发激活。
检查方法很简单：
- 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，看控制台是否有报错； - 在
package.json的activationEvents字段里，确认你注册的事件（如onCommand:myExtension.hello）和实际调用的命令名完全一致（大小写、拼写、冒号位置都不能错）； - 如果想强制触发，可在
launch.json的configurations中添加"runtimeArgs": ["--extensionDevelopmentPath=${workspaceFolder}"]，再手动执行一次对应命令； - 临时把
activationEvents改成*（仅调试用），可让插件一启动就加载，方便验证逻辑是否跑通。
断点进了 activate，但调试器很快断开，是不是 launch.json 配错了？
是的，90% 的“秒退”问题出在 launch.json 的配置偏差。VSCode 插件调试依赖两个关键进程：一个是主编辑器进程（host），另一个是独立启动的“Extension Development Host”窗口（debuggee）。如果它们没对齐，调试器会连上又立刻断开。
必须核对以下三项：
-
"type"必须是extensionHost，不是node或chrome； -
"request"必须是launch，不是attach； -
"outFiles"要指向编译后的out/目录（如["${workspaceFolder}/out/**/*.js"]），否则源码映射失败，断点无法绑定到 TypeScript 行。
一个最小可用配置示例：
{
"version": "0.2.0",
"configurations": [{
"type": "extensionHost",
"request": "launch",
"name": "Launch Extension",
"runtimeExecutable": "${execPath}",
"args": ["--extensionDevelopmentPath=${workspaceFolder}"],
"outFiles": ["${workspaceFolder}/out/**/*.js"]
}]
}
调试时修改代码，为什么热重载不生效？
VSCode 官方插件模板默认不开启热重载（Hot Reload），它只支持“重启整个 Extension Development Host 窗口”来加载新代码。所谓“改完自动生效”，其实是靠 watch 模式 + 手动刷新窗口实现的，并非真正意义上的模块级热替换。
要缩短反馈周期，建议这样操作：
- 终端中运行
npx tsc -w或启用 VSCode 内置的 TS 监听（Ctrl+Shift+B→ 选择 TypeScript: Watch Mode）； - 在 Extension Development Host 窗口中，按
Ctrl+R刷新（等同于重启插件 host），比关窗重开快得多； - 避免在
activate中做耗时初始化（如读大文件、连远程服务），否则每次刷新都要卡住； - 如果真需要热重载能力，得自己集成
vscode-extension-hot-reload这类第三方方案，但会增加构建复杂度，小项目没必要。
调试控制台输出乱码或看不到日志，怎么定位源头？
插件中的 console.log 默认输出到 Extension Development Host 窗口的开发者工具控制台（不是你启动调试的那个 VSCode 窗口的控制台），这是最容易搞混的地方。
正确路径是：
- 在 Extension Development Host 窗口中，按
Ctrl+Shift+I打开 DevTools； - 切到
Console标签页，这里才能看到插件运行时的console输出； - 如果用了
vscode.window.showInformationMessage等 UI API，它们会显示在窗口右下角，不影响控制台； - 若仍无输出，检查
tsconfig.json是否启用了sourceMap: true，否则断点和日志行号可能错位，让你误判执行流。
真正难排查的，是那些发生在 Node.js 后台进程（比如你 spawn 了一个子进程执行 shell 命令）里的日志——它们根本不会进 DevTools 控制台，得改用 vscode.window.showErrorMessage 或写入临时文件来暴露。
