VSCode如何自定义键盘快捷键 VSCode快捷键映射的进阶指南-VSCode-PHP中文网

VSCode如何自定义键盘快捷键 VSCode快捷键映射的进阶指南

蓮花仙者

发布： 2025-08-04 08:46:01

原创

956人浏览过

打开键盘快捷键编辑器，通过ctrl+k ctrl+s（windows/linux）或cmd+k cmd+s（macos）进入；2. 搜索目标命令如“格式化文档”；3. 双击命令并输入新快捷键完成修改；4. 高级用户可编辑keybindings.json文件自定义键绑定，例如添加{ "key": "ctrl+shift+f", "command": "editor.action.formatdocument", "when": "editortextfocus" }；5. 支持多键绑定如"ctrl+k ctrl+0"触发折叠所有区域；6. 自定义设置会覆盖默认快捷键；7. 设置时vscode会提示快捷键冲突，可手动调整；8. 命令id可在快捷键编辑器中查找，如格式化文档的命令id为editor.action.formatdocument；9. 使用when条件如editortextfocus、editorlangid=='javascript'等控制快捷键生效上下文；10. 可通过&&、||、!组合when条件实现精细控制；11. 利用settings sync扩展将快捷键设置同步至github gist，实现多设备配置同步；12. 安装settings sync后登录github账号，创建gist存储配置；13. 使用sync: update/upload settings和sync: download settings命令上传或下载设置；14. 可配置自动同步频率，确保不同设备间设置一致；15. 即使重装系统也能快速恢复个性化快捷键配置，提升工作效率。

VSCode如何自定义键盘快捷键 VSCode快捷键映射的进阶指南

VSCode允许你完全自定义键盘快捷键，提升编码效率。通过修改

keybindings.json

登录后复制

文件，你可以将任何命令绑定到你喜欢的组合键上。

解决方案：

打开键盘快捷键设置： 按下
```
Ctrl+K Ctrl+S
```
登录后复制
（Windows/Linux）或
```
Cmd+K Cmd+S
```
登录后复制
（macOS）打开键盘快捷键编辑器。或者，通过菜单栏
```
文件 -> 首选项 -> 键盘快捷方式
```
登录后复制
打开。
查找命令： 在键盘快捷键编辑器中，搜索你想要修改的命令。例如，如果你想修改格式化文档的快捷键，可以搜索“格式化文档”。
修改快捷键： 找到对应的命令后，双击该命令，VSCode会提示你输入新的快捷键组合。按下你想要的快捷键，然后按
```
Enter
```
登录后复制
确认。
自定义
```
keybindings.json
```
登录后复制
：更高级的自定义方式是直接编辑
```
keybindings.json
```
登录后复制
文件。点击键盘快捷键编辑器右上角的“打开键盘快捷方式(JSON)”按钮，即可打开该文件。
编辑
```
keybindings.json
```
登录后复制
示例： 在
```
keybindings.json
```
登录后复制
中，你可以添加或修改键绑定规则。例如，将
```
Ctrl+Shift+F
```
登录后复制
绑定到格式化文档的命令：

[
    {
        "key": "ctrl+shift+f",
        "command": "editor.action.formatDocument",
        "when": "editorTextFocus"
    }
]

登录后复制

```
key
```
登录后复制
: 你想要使用的快捷键组合。
```
command
```
登录后复制
: VSCode的命令ID。你可以在键盘快捷键编辑器中找到命令ID。
```
when
```
登录后复制
: 一个可选的条件，指定快捷键在什么情况下生效。
```
editorTextFocus
```
登录后复制
表示只有当焦点在编辑器中时才生效。

添加多键绑定： VSCode支持多键绑定，也就是按下多个键的组合来触发命令。例如，先按下
```
Ctrl+K
```
登录后复制
，然后按下
```
Ctrl+0
```
登录后复制
来折叠所有区域：

[
    {
        "key": "ctrl+k ctrl+0",
        "command": "editor.foldAll",
        "when": "editorTextFocus"
    }
]

登录后复制

覆盖默认快捷键： 如果你想修改VSCode默认的快捷键，只需在
```
keybindings.json
```
登录后复制
中添加相同的命令，并绑定到新的快捷键即可。你的自定义设置会覆盖默认设置。
快捷键冲突处理： 修改快捷键时，注意避免与其他快捷键冲突。VSCode会在你设置快捷键时提示冲突，你可以选择修改冲突的快捷键，或者保留当前设置。

如何查找VSCode命令ID？

在键盘快捷键编辑器中搜索命令，找到对应的命令后，命令的左侧会显示命令ID。你也可以在

keybindings.json

登录后复制

文件中查看已有的键绑定，从中找到你需要的命令ID。例如，格式化文档的命令ID是

editor.action.formatDocument

登录后复制

。

爱图表

AI驱动的智能化图表创作平台

305

查看详情

when

登录后复制

语句的用法详解：如何根据上下文定制快捷键？

when

登录后复制

语句允许你根据不同的上下文条件来定义快捷键的行为。这使得你可以为不同的文件类型、不同的编辑器状态等设置不同的快捷键。

常用的
```
when
```
登录后复制
条件：
- ```
editorTextFocus
```
  登录后复制
  : 当焦点在编辑器中时生效。
- ```
editorLangId == 'javascript'
```
  登录后复制
  : 当编辑器的语言ID是JavaScript时生效。
- ```
editorHasSelection
```
  登录后复制
  : 当编辑器中有选中文本时生效。
- ```
inDebugMode
```
  登录后复制
  : 当处于调试模式时生效。
- ```
filesExplorerFocus
```
  登录后复制
  : 当文件资源管理器获得焦点时生效。
```
when
```
登录后复制
语句的组合： 你可以使用
```
&&
```
登录后复制
（与）、
```
||
```
登录后复制
（或）、
```
!
```
登录后复制
（非）等逻辑运算符来组合多个
```
when
```
登录后复制
条件。例如：

[
    {
        "key": "ctrl+shift+f",
        "command": "editor.action.formatDocument",
        "when": "editorTextFocus && editorLangId == 'javascript'"
    }
]

登录后复制

这个例子表示，只有当焦点在编辑器中，并且编辑器的语言ID是JavaScript时，

Ctrl+Shift+F

登录后复制

才会触发格式化文档的命令。

利用
when
登录后复制
语句实现更精细的控制：通过巧妙地使用
```
when
```
登录后复制
语句，你可以根据不同的需求定制快捷键，例如，为不同的文件类型设置不同的代码片段快捷键，或者在调试模式下启用特定的快捷键。

如何同步VSCode的键盘快捷键设置？

VSCode支持通过Settings Sync扩展来同步你的键盘快捷键设置。Settings Sync可以将你的VSCode配置（包括键盘快捷键、主题、扩展等）同步到GitHub Gist或GitHub Enterprise。

安装Settings Sync扩展： 在VSCode扩展商店中搜索“Settings Sync”并安装。
配置Settings Sync： 安装完成后，按照扩展的提示进行配置。你需要登录GitHub账号，并创建一个Gist来存储你的配置。
上传和下载设置： 使用Settings Sync扩展提供的命令（例如，
```
Sync: Update/Upload Settings
```
登录后复制
和
```
Sync: Download Settings
```
登录后复制
）来上传和下载你的设置。
自动同步： Settings Sync支持自动同步，你可以设置自动同步的频率，以便在不同的设备之间保持配置同步。