如何清理VS Code中混乱的键盘快捷键

一、先备份现有配置 #

• 导出Settings Sync配置：按Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），输入Settings Sync: Export Settings，勾选快捷键等需要备份的内容，保存为JSON文件。
• 手动备份快捷键文件：
  • Windows：%APPDATA%\Code\User\keybindings.json
  • Mac：~/Library/Application Support/Code/User/keybindings.json
  • Linux：~/.config/Code/User/keybindings.json
    直接复制该文件到安全目录即可。

二、清理系统级快捷键冲突 #

• 检查Windows系统快捷键：打开Windows设置→系统→键盘→高级键盘设置，或用PowerToys的Keyboard Manager工具，查看并修改与VS Code冲突的系统快捷键（比如Win系列组合键）。
• 在VS Code中禁用冲突的默认绑定：
  1. 打开快捷键编辑器（Ctrl+K Ctrl+S），搜索冲突的快捷键。
  2. 找到对应的默认命令，右键选择「Remove Keybinding」，或者直接在keybindings.json中添加前缀为-的禁用条目，例如：

     { "key": "win+e", "command": "-workbench.view.explorer" }
     

三、重置并重新定义快捷键 #

• 重置到默认绑定：按Ctrl+Shift+P输入Preferences: Reset Keybindings，清空自定义keybindings.json，恢复VS Code默认快捷键。
• 自定义常用快捷键：
  打开keybindings.json（快捷键编辑器右上角点击{}图标），逐条添加自己需要的绑定，支持跨平台适配：

  [
    { "key": "ctrl+shift+f", "command": "workbench.action.findInFiles" },
    { "key": "cmd+s", "command": "workbench.action.files.save", "when": "isMac" },
    { "key": "ctrl+s", "command": "workbench.action.files.save", "when": "!isMac" }
  ]
  

四、程序化批量处理建议 #

• 脚本批量修改keybindings.json：用Python编写脚本批量添加禁用或自定义条目，示例：

  import json
  
  # 读取现有快捷键配置
  with open('./keybindings.json', 'r', encoding='utf-8') as f:
      bindings = json.load(f)
  
  # 批量添加禁用冲突绑定的条目
  conflict_bindings = [
      {"key": "win+tab", "command": "-workbench.action.openRecent"},
      {"key": "ctrl+shift+c", "command": "-workbench.action.terminal.openNativeConsole"}
  ]
  bindings.extend(conflict_bindings)
  
  # 保存修改后的配置
  with open('./keybindings.json', 'w', encoding='utf-8') as f:
      json.dump(bindings, f, indent=2, ensure_ascii=False)
  

• 无扩展启动验证：用code --disable-extensions命令启动VS Code，确认默认快捷键是否正常运行，彻底排除扩展干扰。

附问题示例截图：

内容的提问来源于stack exchange，提问作者Kevin Buchs