VSCode 的 F5 不能启动微信小程序真机调试，因其缺乏微信官方公开的调试协议支持，无法接入小程序私有 JS 引擎与真机通信链路；F5 仅适配 Node.js/Chrome 等标准运行时，而小程序依赖微信开发者工具通过私有桥接协议完成真机调试全流程。
VSCode 本身不支持微信小程序真机调试，所有“快捷键触发调试”本质是触发微信开发者工具的编译或远程调试流程，而非 VSCode 自身执行调试。 真机调试必须由微信开发者工具发起，VSCode 只能辅助编辑、保存、编译触发和源码映射 —— 想靠 F5 或 Ctrl+Shift+P 直接在手机上断点运行，会失败。
为什么 VSCode 的 F5 不能启动微信小程序真机调试？
VSCode 的 F5 是 Node.js / Chrome / Dart 等运行时的调试入口，而微信小程序没有公开的、可被 VSCode debug adapter 接入的调试协议。微信小程序逻辑层运行在独立 JS 引擎（WKWebView / X5 内核），渲染层由自研框架驱动，不暴露 V8 Inspector 或 WebKit Remote Debugging 接口。
- 按
F5会报错Cannot find runtime 'miniprogram'或静默无响应 - 即使配置了
type: "pwa-chrome"，也无法 attach 到真机上的小程序进程 - 微信开发者工具内部使用私有桥接协议与手机通信，VSCode 插件无法复现该链路
哪些 VSCode 快捷键真正有用？
真正能提升真机联调效率的快捷键，只作用于「触发编译」和「打开调试入口」两个环节，且依赖微信开发者工具已就绪：
-
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入Minapp: Compile Project：强制触发微信开发者工具重新编译，适用于修改 WXML/JS 后需立即预览 -
Ctrl+S（配合插件自动编译）：若已开启"minapp.autoCompile": true，保存即编译；但注意频繁保存可能卡死开发者工具，建议仅对.js和.wxml文件启用 -
Ctrl+Shift+I（macOS 是Cmd+Option+I）：在微信开发者工具已打开并运行真机调试窗口时，快速聚焦到其 Sources 面板 —— 这是唯一能“跳转断点”的快捷路径
注意：Ctrl+Shift+I 不是 VSCode 自带功能，而是把焦点切到微信开发者工具窗口后，由它响应的快捷键；VSCode 无法控制该窗口行为。
真机调试前必须手动完成的三步（VSCode 做不了）
这些步骤没有快捷键替代，漏掉任意一步都会导致扫码后白屏、无断点、weapp:// 路径不显示：
- 微信开发者工具中点击「真机调试」按钮（不是「预览」），生成二维码
- 手机微信扫码 → 点击「允许」调试权限 → 等待加载完成（此时真机调试窗口才真正建立 WebSocket 连接）
- 在真机调试窗口的 Sources 面板中，手动切换上下文到
VM Context 1（否则断点不命中、console.log不输出）
常见现象：weapp://pages/index/index.js 显示为黑框、行号错位、debugger 语句不暂停 —— 基本都是没切对上下文，或 source map 路径映射错误（project.config.json 中 miniprogramRoot 写错）。
最易被忽略的是：真机调试窗口里所有断点、console、AppData 查看都依赖这个 VM Context 1 上下文，而 VSCode 完全无法感知或切换它。你看到的“联动”，只是文件路径映射成功后的视觉对齐，背后仍是两个完全隔离的调试环境。
