自定义快捷键 #
快捷键管理概览 #
VSCode 允许你完全自定义快捷键,打造适合自己的操作方式。
text
┌─────────────────────────────────────────────────────────────┐
│ 快捷键管理 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 查看快捷键 │ │ 修改快捷键 │ │ 解决冲突 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 导入导出 │ │ 重置快捷键 │ │ 工作区配置 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
打开快捷键设置 #
基本操作 #
| 功能 | Mac | Windows/Linux | 说明 |
|---|---|---|---|
| 打开键盘快捷方式 | ⌘K ⌘S | Ctrl+K Ctrl+S | 打开快捷键编辑器 |
查看快捷键 #
快捷键列表 #
text
打开快捷键编辑器后:
• 显示所有可用的命令
• 显示当前的快捷键绑定
• 显示快捷键冲突
• 支持搜索和过滤
搜索快捷键 #
text
在快捷键编辑器中:
1. 点击搜索框
2. 输入命令名称或快捷键
3. 查看匹配的结果
示例:
• 搜索 "save" → 查看所有保存相关命令
• 搜索 "⌘s" → 查看使用该快捷键的命令
修改快捷键 #
修改步骤 #
text
1. 打开快捷键编辑器(⌘K ⌘S / Ctrl+K Ctrl+S)
2. 找到要修改的命令
3. 双击命令行
4. 按下新的快捷键组合
5. 按 Enter 确认
快捷键格式 #
json
{
"key": "cmd+shift+s",
"command": "workbench.action.files.saveAll"
}
修改示例 #
text
修改 "保存所有文件" 的快捷键:
1. 搜索 "save all"
2. 双击 "File: Save All"
3. 按 ⌘⇧S / Ctrl+Shift+S
4. 按 Enter 确认
删除快捷键 #
删除步骤 #
text
1. 打开快捷键编辑器
2. 找到要删除的快捷键
3. 右键点击
4. 选择 "移除键绑定"
删除示例 #
text
删除某个快捷键:
1. 找到命令
2. 右键 → "移除键绑定"
3. 快捷键被移除
解决快捷键冲突 #
查看冲突 #
text
在快捷键编辑器中:
• 冲突的快捷键会显示警告图标
• 点击可以查看所有使用该快捷键的命令
解决冲突 #
text
解决冲突的方法:
1. 修改其中一个命令的快捷键
2. 删除不需要的快捷键绑定
3. 使用条件判断区分不同场景
条件快捷键 #
json
{
"key": "cmd+s",
"command": "workbench.action.files.save",
"when": "editorTextFocus"
}
快捷键条件 #
常用条件 #
| 条件 | 说明 |
|---|---|
editorTextFocus |
编辑器有焦点时 |
editorFocus |
编辑器区域有焦点时 |
textInputFocus |
文本输入有焦点时 |
resourceFilename |
当前文件名 |
editorLangId |
当前语言 ID |
inDebugMode |
调试模式时 |
条件示例 #
json
[
{
"key": "f5",
"command": "workbench.action.debug.continue",
"when": "inDebugMode"
},
{
"key": "f5",
"command": "workbench.action.debug.start",
"when": "!inDebugMode"
}
]
快捷键文件 #
用户快捷键文件 #
text
快捷键配置存储在:
Mac: ~/Library/Application Support/Code/User/keybindings.json
Windows: %APPDATA%\Code\User\keybindings.json
Linux: ~/.config/Code/User/keybindings.json
编辑 keybindings.json #
text
1. 打开快捷键编辑器
2. 点击右上角的文件图标
3. 直接编辑 JSON 文件
4. 保存更改
keybindings.json 示例 #
json
[
{
"key": "cmd+shift+s",
"command": "workbench.action.files.saveAll"
},
{
"key": "cmd+d",
"command": "editor.action.copyLinesDownAction",
"when": "editorTextFocus"
},
{
"key": "cmd+shift+d",
"command": "editor.action.copyLinesUpAction",
"when": "editorTextFocus"
}
]
导入导出快捷键 #
导出快捷键 #
text
1. 打开快捷键编辑器
2. 点击右上角的菜单图标
3. 选择 "导出键绑定"
4. 保存 JSON 文件
导入快捷键 #
text
1. 打开快捷键编辑器
2. 点击右上角的菜单图标
3. 选择 "导入键绑定"
4. 选择 JSON 文件
重置快捷键 #
重置单个快捷键 #
text
1. 打开快捷键编辑器
2. 找到要重置的命令
3. 右键点击
4. 选择 "重置键绑定"
重置所有快捷键 #
text
1. 打开快捷键编辑器
2. 点击右上角的菜单图标
3. 选择 "清除所有键绑定"
4. 确认操作
工作区快捷键 #
创建工作区快捷键 #
在项目 .vscode 目录创建 keybindings.json:
json
[
{
"key": "cmd+shift+r",
"command": "workbench.action.tasks.runTask",
"args": "build"
}
]
工作区快捷键优先级 #
text
快捷键优先级:
1. 工作区快捷键(最高)
2. 用户快捷键
3. 默认快捷键(最低)
快捷键实战案例 #
案例1:添加常用命令快捷键 #
json
[
{
"key": "cmd+shift+;",
"command": "editor.action.commentLine"
},
{
"key": "cmd+shift+'",
"command": "editor.action.blockComment"
}
]
案例2:语言特定快捷键 #
json
[
{
"key": "cmd+shift+i",
"command": "editor.action.formatDocument",
"when": "editorLangId == 'javascript'"
},
{
"key": "cmd+shift+i",
"command": "editor.action.formatDocument",
"when": "editorLangId == 'typescript'"
}
]
案例3:调试快捷键 #
json
[
{
"key": "f6",
"command": "workbench.action.debug.stepOver",
"when": "inDebugMode"
},
{
"key": "f7",
"command": "workbench.action.debug.stepInto",
"when": "inDebugMode"
},
{
"key": "f8",
"command": "workbench.action.debug.stepOut",
"when": "inDebugMode"
}
]
快捷键工作流 #
text
┌─────────────────────────────────────────────────────────────┐
│ 快捷键配置流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 需要修改快捷键 │
│ │ │
│ ├─────▶ 打开快捷键编辑器 │
│ │ │ │
│ │ └─▶ ⌘K ⌘S / Ctrl+K Ctrl+S │
│ │ │
│ ├─────▶ 搜索命令 │
│ │ │ │
│ │ └─▶ 输入命令名称 │
│ │ │
│ ├─────▶ 修改快捷键 │
│ │ │ │
│ │ ├─▶ 双击命令 │
│ │ └─▶ 按下新快捷键 │
│ │ │
│ └─────▶ 测试快捷键 │
│ │ │
│ └─▶ 在编辑器中测试 │
│ │
└─────────────────────────────────────────────────────────────┘
快捷键速查表 #
快捷键管理 #
| 功能 | Mac | Windows/Linux |
|---|---|---|
| 打开快捷键编辑器 | ⌘K ⌘S | Ctrl+K Ctrl+S |
编辑操作 #
| 操作 | 说明 |
|---|---|
| 双击 | 修改快捷键 |
| 右键 → 移除 | 删除快捷键 |
| 右键 → 重置 | 重置快捷键 |
常见问题 #
Q: 快捷键不生效? #
A: 检查是否有冲突,或检查条件(when)是否满足。
Q: 如何查看某个快捷键绑定的命令? #
A: 在快捷键编辑器中搜索快捷键(如 “⌘s”)。
Q: 如何备份快捷键配置? #
A: 导出快捷键到 JSON 文件,或使用设置同步功能。
练习建议 #
练习1:修改快捷键 #
text
1. 打开快捷键编辑器
2. 找到 "保存" 命令
3. 修改快捷键
4. 测试新快捷键
练习2:解决冲突 #
text
1. 创建一个快捷键冲突
2. 查看冲突提示
3. 解决冲突
4. 测试快捷键
练习3:创建条件快捷键 #
text
1. 创建一个带条件的快捷键
2. 测试不同场景下的行为
3. 调整条件
下一步 #
现在你已经掌握了自定义快捷键,接下来学习:
最后更新:2026-04-11