F5调试VSCode插件失败主因是package.json中activationEvents或contributes.commands配置错误或未重载窗口；命令须在contributes.commands明确定义且与registerCommand的ID完全一致，console.log输出仅见于Debug Console，修改后必须Developer: Reload Window才生效。
VSCode 插件调试不是“配好 launch.json 就能跑”，而是依赖项目结构、激活时机和输出通道三者对齐；F5 启动失败或断点不触发，90% 是因为 package.json 里 activationEvents 或 contributes.commands 写错，或者没重载窗口。
为什么 F5 启动后命令面板搜不到你的命令
根本原因不是代码没写，而是 VSCode 根本没声明这个命令——它只认 package.json 的 contributes.commands 列表，不读 extension.ts 里的 vscode.commands.registerCommand 调用。
-
contributes.commands必须包含完整命令 ID，比如"command": "myExtension.sayHello"，漏一个字母都不行 - 如果只写了
"onCommand:myExtension.sayHello"，那插件首次执行该命令时才激活；想一开窗口就可用，得加"*"（全部激活）或"onStartup"（VS Code 1.86+ 才支持） - 改完
package.json后必须手动执行Developer: Reload Window，否则新配置不会加载 - 检查
contributes.activationEvents和contributes.commands是否在同一个contributes对象下，缩进错误或逗号遗漏会导致整个字段被忽略
console.log 输出去哪了？为什么断点卡不住
插件的 console.log 默认不出现在主窗口的「调试控制台」，也不在浏览器开发者工具的 Console 面板——它只流向「扩展开发主机」窗口的 Debug Console，除非你显式调用 vscode.window.showInformationMessage() 这类 UI 方法。
- 确认你是在「扩展开发主机」窗口（标题栏带 [Extension Development Host]）中触发命令，主 VS Code 窗口的操作不会进入调试流程
- 按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 切到 Console 标签，才能看到插件运行时报的语法错误（比如ReferenceError: aaf is not defined） - 深度对象（如嵌套 4 层的配置）在 Debug Console 中会显示
Unable to log remote console arguments，此时只能打断点 + 悬停查看 - 新增了
import或修改了permissions字段（如加了"workspace"），必须重载窗口，否则 TS 编译虽成功，但插件加载阶段会因权限缺失静默失败
修改 extension.ts 后要不要重新 F5
不用。TypeScript 默认启用文件监视（watch mode），保存后自动编译到 out/ 目录，F5 启动的是 out/extension.js。
- 但以下情况必须干预：
package.json新增contributes.menus、contributes.keybindings等 UI 扩展点，需清空out/并重新运行npm run compile，否则旧 JS 文件里没有对应注册逻辑 - 右下角出现 TypeScript 编译错误提示（红波浪线），说明变更未成功编译，F5 无效
- 打开「扩展开发主机」→
Output面板 → 切换到Extensions频道，确认有类似[myExtension] Activated的日志；若只有Failed to activate extension，说明activate()函数抛异常且未被捕获 - 新增了
vscode.workspace.onDidChangeConfiguration这类监听器，需重启调试会话才能绑定新事件，仅重载窗口不够
最容易被忽略的调试盲区
不是断点位置或 launch.json 配置，而是插件生命周期本身：VSCode 在启动时只加载已声明激活条件的插件，而 activationEvents 是硬性开关。一个拼写错误的命令 ID、一个遗漏的引号、一次忘记重载窗口，都会让整段逻辑变成“不可见代码”。更隐蔽的是，某些 API（如 vscode.env.openExternal）在非开发模式下会被禁用，但错误不会报在 Debug Console，只会静默失败——这时必须看「扩展开发主机」的开发者工具 Console 才能看到 Proposed API is only available when running out of dev 提示。
