按 Ctrl+Shift+P 执行 Developer: Toggle Keybinding Troubleshooter 可精准定位快捷键冲突源;绿色 ▶ 条目显示实际生效的命令、扩展来源及触发条件;通过 keybindings.json 添加负向规则(如 {"key":"f5","command":"-gitlens.showQuickFileHistory"})可禁用劫持命令;清空 keybindings.json 为最稳还原方式;非美键盘用户须在 settings.json 中设置 "keyboard.dispatch": "keyCode" 以修复按键识别问题。

Developer: Toggle Keybinding Troubleshooter 一查就准
按 Ctrl+Shift+P 输入并执行 Developer: Toggle Keybinding Troubleshooter,然后立刻按 F5 或 Ctrl+Shift+B。面板里带 ▶ 的绿色条目,就是当前真正在执行的命令——它会明确显示来源扩展(比如 GitLens)、完整命令 ID(如 gitlens.showQuickFileHistory)和触发条件。灰色条目只是 when 不满足,不用管。
keybindings.json 里用 - 前缀禁用劫持命令
确认是某个扩展抢了快捷键后,不卸载、不关设置,直接在用户级 keybindings.json 里加一条负向规则:
[{"key":"f5","command":"-gitlens.showQuickFileHistory"}]
-
command必须写全命令 ID,右键快捷键列表对应项 → “复制命令 ID” 最稳妥,手敲容易大小写或点号出错 - 这条只取消绑定,
F5不会变灰也不会报错,但也不再触发任何操作——你得自己补一条新绑定,否则等于废掉 - 别写
"command": ""或null,VSCode 会整条忽略该配置
清空 keybindings.json 是最稳的默认还原方式
如果不确定哪条配置坏了,或者想彻底回归出厂状态:
- 按
Ctrl+Shift+P→ 执行Preferences: Open Keyboard Shortcuts (JSON) - 确认路径是用户目录下的
keybindings.json(如~/.config/Code/User/keybindings.json) - 删光全部内容,只留一个空数组
[]—— 不是注释掉、不是留空行、也不是写成{} - 保存(
Ctrl+S),无需重启,更改立即生效
非美键盘用户必须检查 keyboard.dispatch
中文键盘用户常遇到 F5 按了没反应,其实是 VSCode 默认按字符 dispatch,把物理按键识别错了。必须在 settings.json 里加这一行:
"keyboard.dispatch": "keyCode"
- 值必须是字符串
"keyCode",写成true、"code"或"key"都无效 - 这个配置不能塞进
keybindings.json,必须放在settings.json里 - 改完保存,VSCode 立刻重载映射逻辑,不需要重启
真正麻烦的不是找不到冲突源,而是某些劫持发生在 when 条件满足的瞬间——比如 GitLens 只在编辑器聚焦且光标在代码行时才激活绑定,这种动态覆盖很难靠肉眼发现。











