在 VSCode 中自定义快捷键需编辑 keybindings.json:通过 Cmd+Shift+P 运行 Preferences: Open User Keybindings 打开文件;添加含 key、command、when 字段的 JSON 对象;设 command 为空可禁用默认键;when 可限定触发条件;也可通过 Cmd+K Cmd+S 图形界面同步修改。
如果您希望在 visual studio code 中自定义快捷键以提升编码效率,则需要直接编辑 keybindings.json 文件。该文件允许您覆盖默认键绑定、为命令分配新组合键,或禁用冲突的快捷方式。以下是实现此目标的具体操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、打开 keybindings.json 文件
VSCode 提供两种方式访问用户级快捷键配置文件:一种是通过图形界面快速打开,另一种是手动定位 JSON 文件路径。推荐使用内置命令确保路径准确且避免权限问题。
1、启动 VSCode,按下 Cmd + Shift + P(Windows/Linux 为 Ctrl + Shift + P)调出命令面板。
2、在命令面板中输入 Preferences: Open User Keybindings 并回车。
3、此时将打开一个名为 keybindings.json 的编辑器标签页,内容为当前用户的快捷键覆盖配置。
二、添加自定义快捷键映射
每个快捷键条目是一个 JSON 对象,包含 key(触发按键)、command(执行命令)、when(触发条件)三个核心字段。添加新绑定时需确保 command 值真实存在,可通过命令面板搜索验证。
1、在 keybindings.json 的方括号内插入新对象,格式如下:
2、输入 { "key": "ctrl+alt+b", "command": "workbench.action.terminal.toggleTerminal" }。
3、保存文件(Cmd + S),新快捷键立即生效,无需重启编辑器。
三、禁用默认快捷键
当某个内置快捷键与习惯冲突或引发误操作时,可通过设置 command 字段为空字符串来屏蔽它,VSCode 将跳过该键组合的响应流程。
1、在 keybindings.json 中新增对象。
2、填入 { "key": "cmd+d", "command": "" } 以禁用多光标选择功能。
3、确认该条目未被其他扩展覆盖,可在命令面板中执行 Developer: Toggle Developer Tools 查看 Console 是否报错。
四、基于上下文条件启用快捷键
when 字段用于限定快捷键仅在特定 UI 状态下生效,例如仅在编辑器聚焦且非调试模式时响应,可大幅降低误触概率并增强场景适配性。
1、查找目标命令的 when 条件标识符,方法是打开命令面板,输入 Developer: Inspect Context Keys 并点击提示区域。
2、在 keybindings.json 中添加完整条目:{ "key": "alt+up", "command": "editor.action.moveLinesUpAction", "when": "editorTextFocus && !editorReadonly" }。
3、保存后,在只读文件中按下 Alt+Up 将不再触发行上移操作。
五、从键盘快捷键设置界面同步修改
图形化快捷键编辑器支持直接点击绑定项进行编辑,并会自动将变更写入 keybindings.json。该方式适合不熟悉 JSON 语法的用户,同时保留结构完整性。
1、按下 Cmd + K,然后松开再按 Cmd + S 打开快捷键设置界面。
2、在搜索框中输入关键词如 format,找到 editor.action.formatDocument。
3、鼠标悬停在对应快捷键上,点击铅笔图标,输入新组合键(如 Cmd+Shift+I),回车确认。










