如何自定义VSCode的键盘映射和快捷键组合？-VSCode-PHP中文网

答案：通过修改keybindings.json或使用图形界面可自定义VSCode快捷键，实现效率提升；需注意命令ID查找、冲突排查及when条件设置。

如何自定义vscode的键盘映射和快捷键组合？

VSCode的键盘映射和快捷键组合，本质上就是一套可以完全定制的命令触发机制。你可以通过修改

keybindings.json

登录后复制

文件，或者利用其内置的图形界面工具，来重新定义、添加或禁用任何快捷键，从而让VSCode完全贴合你的个人操作习惯，这对于提升开发效率来说，简直是质的飞跃。

解决方案

自定义VSCode的键盘映射和快捷键组合，主要有两种方式，但最终都会归结到

keybindings.json

登录后复制

这个核心文件上。

首先，最直观的方式是通过VSCode的图形界面：

打开VSCode，按下
```
Ctrl+K Ctrl+S
```
登录后复制
（或者通过菜单栏
```
文件 > 首选项 > 键盘快捷方式
```
登录后复制
）。
你会看到一个搜索框和密密麻麻的快捷键列表。在这里，你可以搜索特定的命令（比如“保存”、“格式化文档”），然后点击对应的快捷键进行修改。
点击某个命令左侧的加号，VSCode会提示你按下新的快捷键组合。输入后，它会帮你生成一个
```
keybindings.json
```
登录后复制
条目。
如果你想移除某个快捷键，可以直接在搜索结果中右键点击，选择“移除键绑定”。

然而，我个人觉得，直接编辑

keybindings.json

登录后复制

才是真正解锁VSCode自定义潜力的钥匙。

在键盘快捷方式界面，点击右上角的
```
{}
```
登录后复制
图标，这会打开你的用户
```
keybindings.json
```
登录后复制
文件。这个文件会覆盖VSCode的默认设置。
```
keybindings.json
```
登录后复制
是一个JSON数组，每个对象代表一个快捷键绑定，通常包含三个核心属性：
- ```
key
```
  登录后复制
  : 你想要设置的快捷键组合，比如
```
"ctrl+shift+p"
```
  登录后复制
  。
- ```
command
```
  登录后复制
  : 你希望这个快捷键触发的VSCode命令ID，比如
```
"workbench.action.showCommands"
```
  登录后复制
  。
- ```
when
```
  登录后复制
  : 一个可选的上下文条件，只有当这个条件为真时，快捷键才会生效。比如
```
"editorTextFocus"
```
  登录后复制
  表示只有当文本编辑器获得焦点时。
添加自定义快捷键： 在数组中添加一个新的JSON对象。
```
[
    {
        "key": "ctrl+alt+a",
        "command": "editor.action.addCommentLine",
        "when": "editorTextFocus"
    }
]
```
登录后复制
这个例子会让你在编辑器中按下
```
Ctrl+Alt+A
```
登录后复制
时，快速添加行注释。
覆盖或禁用现有快捷键： 如果你想要修改一个默认快捷键的行为，或者彻底禁用它，你也可以在
```
keybindings.json
```
登录后复制
中添加条目。
- 覆盖： 简单地为同一个
```
key
```
  登录后复制
  和
```
when
```
  登录后复制
  条件指定不同的
```
command
```
  登录后复制
  ，你的自定义设置会优先。
- 禁用： 将
```
command
```
  登录后复制
  设置为一个以
```
-
```
  登录后复制
  开头的命令ID，例如，
```
"-workbench.action.quit"
```
  登录后复制
  会禁用默认的退出快捷键。
```
[
// 禁用Ctrl+Q退出VSCode
{
    "key": "ctrl+q",
    "command": "-workbench.action.quit"
},
// 重新定义Ctrl+Q，使其在编辑器中执行保存所有文件操作
{
    "key": "ctrl+q",
    "command": "workbench.action.files.saveAll",
    "when": "editorTextFocus"
}
]
```
  登录后复制
  通过这种方式，你可以精细控制每一个快捷键的行为，甚至为同一个快捷键在不同上下文设置不同的功能。

如何查找VSCode内置命令ID以进行自定义映射？

刚开始接触的时候，我常常觉得找这些命令ID像大海捞针，毕竟VSCode命令那么多，官方文档里也不是每个都列得一清二楚。但后来发现，其实VSCode自己就提供了最好的工具，根本不用跑到外面去。

最直接有效的方法就是利用“键盘快捷方式”界面（

Ctrl+K Ctrl+S

登录后复制

）。

打开这个界面后，在顶部的搜索框中输入你想要实现的功能的关键词，比如“格式化”、“保存”、“切换侧边栏”等等。
搜索结果会列出所有相关的命令。你会发现，每个命令的左侧通常会显示它的默认快捷键，而命令本身的描述下方，往往会直接显示它的命令ID。比如，搜索“格式化”，你可能会看到
```
editor.action.formatDocument
```
登录后复制
这个ID。
当你找到想要的命令ID后，就可以把它复制到你的
```
keybindings.json
```
登录后复制
文件中使用了。

另一种辅助方法是使用命令面板（

Ctrl+Shift+P

登录后复制

）。

打开命令面板，然后输入你想要执行的操作。
虽然命令面板本身不直接显示命令ID，但它会列出命令的友好名称。有时候，通过友好名称和一些关键词，你可以在“键盘快捷方式”界面更容易地定位到对应的命令ID。
对于一些不那么常见的命令，你可能需要在VSCode的官方文档中搜索，通常文档会提供命令ID。

偶尔，如果我想了解某个特定UI元素的背后命令，我会打开开发者工具（

Help > Toggle Developer Tools

登录后复制

），在Console里进行一些探索，但这通常是针对更高级的调试需求，对于日常自定义来说，前两种方法足够了。

为什么我的自定义快捷键不起作用或与现有快捷键冲突？

我记得有一次，我花了好久才发现一个快捷键不生效，仅仅是因为

when

登录后复制

条件写错了，那种感觉真是...哭笑不得。自定义快捷键不生效，或者行为不如预期，这几乎是每个VSCode用户都会遇到的“成长烦恼”。通常，这背后有几个常见的原因：

Poixe AI

统一的 LLM API 服务平台，访问各种免费大模型

查看详情

快捷键冲突是罪魁祸首： 这是最常见的情况。你设置的快捷键可能已经被VSCode的默认设置或其他扩展占用了。
- 如何排查： 再次打开“键盘快捷方式”界面（
```
Ctrl+K Ctrl+S
```
  登录后复制
  ），在搜索框中直接按下你自定义的快捷键组合（比如
```
Ctrl+Alt+A
```
  登录后复制
  ）。VSCode会列出所有绑定到这个快捷键的命令。
- VSCode的解析顺序： VSCode在解析快捷键时，会考虑默认绑定、扩展绑定以及你的用户自定义绑定。通常，用户自定义的
```
keybindings.json
```
  登录后复制
  中的条目优先级最高，但如果
```
when
```
  登录后复制
  条件不匹配，或者有更具体的默认绑定，可能会导致你的自定义失效。
- 解决方案： 如果发现冲突，你可以选择：
  - 更换一个不冲突的快捷键。
  - 明确禁用冲突的默认命令。在
```
keybindings.json
```
    登录后复制
    中，添加一个条目，将
```
command
```
    登录后复制
    设置为以
```
-
```
    登录后复制
    开头的冲突命令ID，比如
```
{ "key": "ctrl+alt+a", "command": "-some.conflicting.command" }
```
    登录后复制
    。这样，你的自定义命令就能“上位”了。
```
when
```
登录后复制
上下文条件不匹配： 这是另一个非常容易被忽视，但又极其重要的因素。
```
when
```
登录后复制
子句决定了你的快捷键在什么“场景”下才会生效。
- 比如，你设置了一个快捷键，但
```
when
```
  登录后复制
  条件是
```
editorTextFocus
```
  登录后复制
  （编辑器获得焦点），而你却在文件管理器中尝试使用它，那自然不会有任何反应。
- 排查： 仔细检查你的
```
when
```
  登录后复制
  子句是否与你期望的使用场景一致。VSCode的
```
when
```
  登录后复制
  上下文条件非常丰富，从文件类型、活动面板、调试状态到配置项，都可以作为条件。
- 解决方案： 调整
```
when
```
  登录后复制
  条件，使其符合你的预期。如果不确定，可以尝试暂时移除
```
when
```
  登录后复制
  条件，看看快捷键是否生效，如果生效，就说明问题出在
```
when
```
  登录后复制
  上。
命令ID或快捷键拼写错误： 简单粗暴，但确实会发生。一个字母的差异，一个不规范的组合（比如
```
ctrl++
```
登录后复制
而不是
```
ctrl+=
```
登录后复制
），都可能导致快捷键不工作。
- 排查： 仔细核对
```
keybindings.json
```
  登录后复制
  中的
```
key
```
  登录后复制
  和
```
command
```
  登录后复制
  属性值。
VSCode或扩展缓存问题： 虽然不常见，但偶尔在编辑
```
keybindings.json
```
登录后复制
后，VSCode可能没有立即加载最新的配置。
- 解决方案： 尝试重启VSCode。有时禁用或重新启用相关扩展也能解决问题。

如何实现基于上下文的智能快捷键？

玩转

when

登录后复制

子句，才是真正把VSCode变成你专属开发利器的开始。它能让你的快捷键不再是死板的命令，而是能“理解”你当前工作状态的智能伙伴。基于上下文的智能快捷键，核心就是利用

keybindings.json

登录后复制

中的

when

登录后复制

属性来定义快捷键的生效条件。

when

登录后复制

属性接受一个布尔表达式，这个表达式会根据VSCode的当前状态进行评估。只有当表达式为真时，对应的快捷键绑定才会激活。这使得你可以为同一个快捷键组合，在不同的场景下赋予完全不同的功能。

这里有一些常用的

when

登录后复制

上下文条件及其应用场景：

editorTextFocus
登录后复制
: 当文本编辑器获得焦点时。这是最常用的条件之一，确保快捷键只在编辑代码时生效。
- 示例：
```
ctrl+s
```
  登录后复制
  保存文件，只在编辑器有焦点时才触发。
explorerViewletFocus
登录后复制
: 当文件资源管理器获得焦点时。
- 示例：
```
enter
```
  登录后复制
  键在文件资源管理器中用于打开文件，而在编辑器中则插入换行。
terminalFocus
登录后复制
: 当集成终端获得焦点时。
- 示例：
```
ctrl+c
```
  登录后复制
  在终端中是终止进程，在编辑器中是复制。
debugState != 'inactive'
登录后复制
: 当调试会话处于活动状态时。
- 示例：
```
f5
```
  登录后复制
  在调试时是继续/开始调试，在其他时候可能被用于其他功能。
resourceExtname == '.js'
登录后复制
或
resourceLangId == 'typescript'
登录后复制
: 根据当前打开文件的扩展名或语言ID。
- 示例： 你可以设置一个
```
ctrl+shift+f
```
  登录后复制
  ，在JavaScript文件中触发ESLint修复，而在Python文件中触发Black格式化。
config.editor.wordWrap
登录后复制
: 根据VSCode的某个配置项。
- 示例： 某个快捷键只有在代码自动换行开启时才生效。
组合条件： 你可以使用
```
&&
```
登录后复制
（与）、
```
||
```
登录后复制
（或）、
```
!
```
登录后复制
（非）来组合多个条件。
- 示例：
```
editorTextFocus && !editorReadonly
```
  登录后复制
  表示只有在文本编辑器有焦点且不是只读模式时。

实际应用示例：同一个快捷键，不同功能

假设你希望

Ctrl+J

登录后复制

这个快捷键在终端里用来切换最大化面板，而在编辑器里用来合并代码行。你可以这样配置：

[
    {
        "key": "ctrl+j",
        "command": "workbench.action.toggleMaximizedPanel",
        "when": "terminalFocus" // 在终端获得焦点时，切换最大化面板
    },
    {
        "key": "ctrl+j",
        "command": "editor.action.joinLines",
        "when": "editorTextFocus" // 在编辑器获得焦点时，合并行
    }
]

登录后复制

通过这种方式，