VSCode调试快捷键必须写入keybindings.json并配置正确when条件才能生效;关键命令如F10跳过需满足"inDebugMode"等上下文,命令ID须准确复制,修饰键顺序和功能键写法须严格规范。

VSCode 调试快捷键不能靠 GUI 界面“点一点”就稳定生效——真正可控、可复现、跨设备同步的调试键绑定,必须写进 keybindings.json,且多数关键操作(如“跳过”“步入”“继续”)默认没有全局快捷键,得手动加 when 条件才能在调试时触发。
调试快捷键没反应?先确认是否在调试上下文中
VSCode 的调试命令(如 workbench.action.terminal.toggleTerminal 这类非调试命令除外)默认只在调试器激活时才可用,但“调试器激活”不等于“有断点”或“正在运行”,而是要满足特定上下文变量。常见现象是:你按了 F10 没反应,不是键没绑,而是 when 条件没匹配上。
-
"when": "inDebugMode"—— 表示调试会话已启动(哪怕暂停在断点前),这是最常用也最稳妥的条件 -
"when": "debugState == 'stopped'"—— 仅在断点处暂停时生效,F5(继续)或F8(断开)就不该用这个,否则按了没反馈 - 别只写
"when": "editorTextFocus"—— 编辑器有焦点 ≠ 调试器就绪,这种配置会让调试键在写代码时误触发(比如意外继续执行) - 想同时满足“调试中 + 编辑器有焦点”?用
"when": "inDebugMode && editorTextFocus",避免在调试控制台里误按
keybindings.json 里怎么写调试命令才不拼错
调试相关命令 ID 不是凭印象写的,比如 “单步跳过”不是 debug.skip 或 stepOver,而是 VSCode 官方定义的固定字符串。错一个字母或大小写,整条绑定就静默失效。
- 最可靠方式:打开命令面板(
Ctrl+Shift+P),输入Debug: Toggle Breakpoint,右键该条目 → “复制命令 ID”,得到editor.debug.action.toggleBreakpoint - 高频调试命令 ID 直接记这几个:
workbench.action.terminal.toggleTerminal(不是调试命令,举例说明命名风格)、workbench.action.debug.continue(F5 继续)、workbench.action.debug.stepOver(F10 跳过)、workbench.action.debug.stepInto(F11 步入)、workbench.action.debug.stop(Shift+F5 停止) -
key字段修饰键顺序必须严格为ctrl→shift→alt→meta(macOS 用cmd),例如"ctrl+shift+f5"✅,"shift+ctrl+f5"❌(VSCode 可能忽略) - 功能键写全称:
"f5"、"f10"、"escape",不能写成"F5"或"esc"
覆盖默认调试键(比如改掉 F5)要小心这三件事
很多人想把 F5 改成“运行当前文件”,结果发现改完后断点失效、调试窗口打不开——问题不在命令 ID,而在上下文冲突和覆盖逻辑。
- 默认
F5绑定的是workbench.action.debug.start,它依赖when: "!inDebugMode";你若直接覆盖成另一个命令(比如python.execInTerminal),就得自己补上等效条件,否则在调试中按F5会干两件事:先停掉当前调试,再执行你的命令 - 禁用原绑定更安全:加一条
{"key":"f5","command":"-workbench.action.debug.start"},注意-必须紧贴命令名,不能有空格 - 系统级拦截优先于 VSCode:Windows 上
F5可能被浏览器劫持(如果你在 VSCode 里切到浏览器标签页再按),macOS 的 Spotlight(Cmd+Space)也可能吞掉Cmd+组合——先关掉干扰软件再测试
为什么你在终端/调试控制台里按调试键没反应
这不是 bug,是设计使然。VSCode 把“调试控制台”(Debug Console)和“终端”(Terminal)视为不同上下文,它们不共享 inDebugMode 状态。即使调试会话正在运行,在调试控制台里按 F10 也不会跳过,因为此时焦点不在编辑器,而你的 when 条件很可能写了 editorTextFocus。
- 如果真需要在调试控制台里执行命令(比如重载变量),得单独加一条绑定,
when改成"debugConsoleFocused"(需 VSCode 1.85+) - 更常见的做法是:不给调试控制台设调试键,专注在编辑器里操作;所有变量检查用鼠标悬停或 Watch 面板,比快捷键更稳
- 跨平台要注意:
cmd在 macOS 是 meta 键,但 Windows 没有对应物理键;统一用ctrl开头的组合(如ctrl+shift+f10),VSCode 会自动映射为 macOS 的cmd+shift+f10,不用写两套配置
真正难的不是写对语法,而是判断当前焦点在哪、when 表达式是否求值为 true、有没有插件在后台悄悄改了上下文变量——这些没法靠重装扩展解决,得靠 Developer: Inspect Context Keys 实时看变量值。











