VSCode插件调试核心技巧分享-VSCode-PHP中文网

vscode插件入口是extension.ts的activate函数，需满足activationevents条件才触发；确认方法：打开extension development host的devtools（ctrl+shift+i），执行对应命令（如ctrl+shift+p输入命令名），检查控制台输出及断点是否命中。

vscode插件调试核心技巧分享

调试插件时 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 行。

一个最小可用配置示例：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

{
  "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 这类第三方方案，但会增加构建复杂度，小项目没必要。