自定义快捷键 #

快捷键管理概览 #

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