在VSCode中自定义调试（Debug）相关快捷键-VSCode-PHP中文网

f5等调试快捷键失效主因是debugstate上下文不匹配、launch.json缺失或错误、系统/插件热键劫持及command id拼写错误；需依次验证debugstate值、配置文件存在性、扩展启用状态及键盘拦截。

在vscode中自定义调试（debug）相关快捷键

直接改 keybindings.json，别信 GUI 界面能搞定调试快捷键——它不显示 when 条件、不暴露调试上下文依赖，改了也大概率静默失效。

为什么 Ctrl+F5 / F5 按了没反应？查 `debugState` 上下文

VSCode 的调试命令（如 workbench.action.debug.start、workbench.action.debug.stepOver）默认只在特定调试状态下生效。你按 F5 没反应，不是命令没绑，而是当前 debugState 不是 'inactive' 或 'stopped'。

打开命令面板（Ctrl+Shift+P），运行 Developer: Inspect Context Keys，点击编辑器任意位置，看输出里是否有 debugState 字段及值
常见合法值：inactive（未启动调试）、starting、stopped（断点暂停）、running（正在运行）
想让 F5 始终启动调试？加 "when": "debugState == 'inactive' || debugState == 'stopped'"；只在暂停时单步？用 "when": "debugState == 'stopped'"
别漏 editorTextFocus：光标不在编辑器里（比如聚焦在终端或调试控制台），debugState 再匹配也没用

`workbench.action.debug.*` 命令名必须写全，大小写敏感

调试相关命令 ID 全部以 workbench.action.debug. 开头，不是 debug. 或 editor.debug.，拼错一个字母就无效。

VSCode

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

下载

常用命令示例：

{
  "key": "f5",
  "command": "workbench.action.debug.start",
  "when": "debugState == 'inactive'"
},
{
  "key": "f10",
  "command": "workbench.action.debug.stepOver",
  "when": "debugState == 'stopped'"
},
{
  "key": "f11",
  "command": "workbench.action.debug.stepInto",
  "when": "debugState == 'stopped'"
}

workbench.action.debug.restart 和 workbench.action.debug.stop 同样需要对应 debugState 条件，比如 stop 通常要求 debugState != 'inactive'
命令 ID 可在 GUI 快捷键界面中右键某条调试命令 → “复制命令 ID”，别凭记忆手敲

避免被扩展或系统热键劫持：F8/F9/F10 是高危区

F8、F9、F10 这类功能键最容易被干扰——Mac 上可能被“勿扰模式”或“语音控制”吞掉；Windows 可能被厂商驱动（如 Dell Command | Power Manager）或 Logitech Options 截获；VSCode 插件如 GitLens、Thunder Client 也常悄悄绑定 F9（切换断点）。

验证是否被系统拦截：临时退出所有第三方工具（尤其是输入法、键盘管理软件），再试
查谁占了 F9：在 GUI 快捷键界面顶部搜 f9，看“来源”列是 Default、Extension 还是 User；如果是扩展，先禁用它测试
不想禁用扩展但要抢回 F9？加一条用户绑定并显式禁用原命令：
```
{"key": "f9", "command": "-editor.debug.action.toggleBreakpoint"}
```
，再另起一行绑定你自己的逻辑
非美式键盘用户注意：keyboard.dispatch 设为 "keyCode"（在 settings.json 中），否则 F 键可能被识别成其他字符

调试快捷键生效的前提：launch.json 存在且配置正确

再完美的快捷键绑定，也救不了缺失调试配置的项目。VSCode 不会因为你按了 F5 就自动猜你要跑什么——它只检查工作区根目录或 .vscode/launch.json 是否存在有效配置。

如果按 F5 提示 “No configuration”，说明 launch.json 缺失或语法错误，快捷键本身再对也触发不了任何动作
确保 launch.json 中至少有一个 configurations 项，且 type 字段值（如 node、python、chrome）与已安装的调试扩展匹配
快捷键不会自动激活调试扩展；如果扩展未启用（比如 Python 扩展被禁用），workbench.action.debug.start 仍会执行，但后续报错，此时 debugState 可能卡在 starting 状态，导致后续 F10/F11 失效