能直接调试 vscode 插件的关键是确保 activate 函数被正确触发、断点命中且 deactivate 可验证；需正确配置 activationevents、main 字段、插件 id，以及 launch.json 中 type 为 extensionhost、runtimeexecutable 指向 vscode、args 包含 --extensiondevelopmentpath。
能直接调试 VSCode 插件，关键不是装一堆工具，而是确保 activate 函数能在本地开发时被正确触发、断点能命中、且 deactivate 清理行为可验证。 其他步骤都是围绕这个核心服务的。装错 Node.js 版本、用错 package.json 的 activationEvents、或没配好 launch.json 的 program 路径，都会导致“代码改了但调试器不进断点”这种静默失败。
为什么 yo code 初始化后还不能直接按 F5 调试？
因为默认生成的模板只提供了骨架，缺少运行时上下文。VSCode 插件必须在一个“宿主 VSCode 实例”中加载才能执行，而 yo code 生成的项目本身不会自动启动这个宿主环境。
- 必须手动配置
.vscode/launch.json，其中type必须是extensionHost，不是node或chrome -
request必须是launch，且runtimeExecutable应指向你本地安装的 VSCode 可执行文件（Windows 是Code.exe，macOS 是Visual Studio Code.app） -
args数组里必须包含--extensionDevelopmentPath=${workspaceFolder}，否则宿主实例根本不知道要加载哪个插件 - 首次调试前需运行
npm install和npm run compile（或npm run watch），确保out/extension.js存在且是最新的
activate 不执行？检查这三项硬性条件
VSCode 不会无条件加载你的插件，它依赖 package.json 中的声明来决定何时触发 activate。常见失效场景不是代码写错了，而是声明没对上。
-
activationEvents必须显式列出至少一个事件，比如*（启动即激活）、onCommand:my-extension.helloWorld（执行命令时激活）、或onLanguage:javascript（打开 JS 文件时激活）。空数组或缺失该字段 = 插件永远不激活 -
main字段必须指向编译后的入口文件，例如./out/extension.js；如果还写成./src/extension.ts，Node.js 会直接报错无法 require - 插件
id（即publisher.name组合）不能与已安装的其他插件重复，否则新版本会被忽略——可在调试控制台里看输出日志是否出现Skipping activation
调试时断点失效的典型路径问题
VSCode 调试器靠 source map 关联 TypeScript 源码和编译后的 JavaScript。一旦路径错位，断点就悬在源码上，实际执行的是另一份 JS。
-
tsconfig.json中outDir和sourceRoot必须匹配：若outDir是./out，则sourceRoot应设为../src（相对out目录而言） -
launch.json中的sourceMaps必须为true，且outFiles应明确指定为["${workspaceFolder}/out/**/*.js"] - 不要手动修改
out/下的文件——所有调试都应基于src/修改 + 自动编译流程，否则 source map 会失效 - Windows 用户注意路径分隔符：VSCode 内部统一用
/，即使系统是\，sourceMapPathOverrides里也别写反斜杠
最易被忽略的是 activationEvents 的语义约束：它不是“我写了就能触发”，而是“VSCode 看到这个事件才去查有没有插件监听”。比如你写了 onCommand:xxx 却没注册对应命令，或者写了 onLanguage:json 但打开的是 .js 文件，activate 就永远不会调。调试前先确认控制台里有没有 Extension 'xxx' is activated. 这类日志，没有就说明根本没走到那一步——别急着调代码逻辑。
