扩展开发主机是隔离的调试专用实例，预装当前未发布插件，仅加载该扩展，执行activate、注册命令与监听事件，并在“log (extension host)”输出日志。

按 F5 启动的“扩展开发主机”窗口到底在干什么

它不是普通的新 VSCode 窗口，而是一个隔离的、预装了你当前插件（未发布）的独立实例。所有 activate 函数调用、命令注册、事件监听都在这个环境里生效；你在主 VSCode 里改代码，F5 重启后，它才重新加载——这意味着你不能靠刷新页面来更新逻辑，必须重启调试会话。

为什么改了代码却看不到新命令出现在命令面板

常见原因有三个：

• package.json 中的 contributes.commands 没同步新增命令项，只写了 vscode.commands.registerCommand 是不够的
• activationEvents 配置错误，比如写成了 onCommand:myExtension.doSomething，但注册时用的是 myExtension.somethingElse
• 没触发激活事件：例如设了 onLanguage:json，却在 .ts 文件里打开命令面板，命令根本不会被加载

调试时 console.log 不输出？别急着怀疑代码

VSCode 插件的日志默认不出现在调试控制台主界面，而是藏在「Output」面板里，且需要手动切换频道：

VSCode

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

下载

• 按 Ctrl+Shift+U（Windows/Linux）或 Cmd+Shift+U（macOS）打开 Output 面板
• 下拉选择「Log (Extension Host)」而非「Debug」或「Tasks」
• 确保 extension.ts 里的日志是在 activate 执行后打的——activate 外层的顶层 console.log 在插件加载前就执行完了，根本不会出现

修改后不想每次 F5 重启？可以启用热重载，但有前提

热重载（live reload）不是开箱即用的，它依赖两个条件：

• 项目中启用了 TypeScript 的 --watch 模式（通常由 npm run watch 或 ts-node -T 提供）
• launch.json 的 configurations 里设置了 "runtimeArgs": ["--nolazy"] 和 "sourceMaps": true，否则断点和代码映射会失效
• 即使满足以上，activate 函数本身仍只执行一次；动态逻辑（如新注册的命令）需手动调用 vscode.commands.executeCommand('workbench.action.reloadWindow') 或使用插件如 Extension Reloader

真正容易被忽略的是：扩展开发主机里禁用了大部分已安装插件（包括你正在开发的那个以外的所有），所以不要指望它能复现用户真实环境里的交互冲突。测试兼容性，得打包成 .vsix 后手动安装到干净的 VSCode 实例里。