Visual Studio Code 允许您直接通过键盘执行大多数任务。此页面列出了默认绑定（键盘快捷键）并描述了如何更新它们。

注意：如果您在 Mac 上访问此页面，您将看到 Mac 的按键绑定。如果您使用 Windows 或 Linux 进行访问，您将看到该平台的密钥。如果您需要其他平台的按键绑定，请将鼠标悬停在您感兴趣的按键上。

Visual Studio Code 使用键盘快捷键编辑器提供丰富且简单的键盘快捷键编辑体验。它列出了所有带或不带键绑定的可用命令，您可以使用可用操作轻松更改/删除/重置其键绑定。它的顶部还有一个搜索框，可以帮助您查找命令或键绑定。您可以通过转到File > Preferences > Keyboard Shortcuts下的菜单来打开此编辑器。

最重要的是，您可以根据键盘布局查看键绑定。例如，当布局更改为德语时，美式键盘布局中的键绑定Cmd+\将显示为Ctrl+Shift+Alt+Cmd+7 。输入键绑定的对话框将根据您的键盘布局分配正确且所需的键绑定。

要进行更高级的键盘快捷键自定义，请阅读高级自定义。

键盘快捷键对于生产力至关重要，而改变键盘习惯可能很困难。为了帮助解决此问题，“文件” > “首选项” > “从...迁移键盘快捷键”会显示流行的键盘映射扩展列表。这些扩展修改 VS Code 快捷键以匹配其他编辑器的快捷键，因此您无需学习新的键盘快捷键。市场中还有一个键盘映射类别的扩展。

提示：单击上面的扩展程序图块可阅读说明和评论，以决定哪个扩展程序最适合您。在市场中查看更多内容。

我们还有这些键盘快捷键的可打印版本。帮助>键盘快捷键参考显示适合打印的压缩 PDF 版本，作为简单参考。

以下是三个特定于平台的版本（美国英语键盘）的链接：

如果您安装了许多扩展或者自定义了键盘快捷键，有时可能会出现键绑定冲突，即同一键盘快捷键映射到多个命令。这可能会导致令人困惑的行为，特别是当您在编辑器中移动时不同的键绑定进入和超出范围时。

键盘快捷键编辑器有一个上下文菜单命令显示相同的键绑定，它将根据键盘快捷键过滤键绑定以显示冲突。

选择一个您认为过载的键绑定命令，您可以查看是否定义了多个命令、键绑定的来源以及它们何时处于活动状态。

要解决按键绑定问题，您可以执行命令Developer: Toggle Keyboard Shortcuts Troubleshooting。这将激活已调度键盘快捷键的日志记录，并将打开带有相应日志文件的输出面板。

然后，您可以按所需的键绑定并检查 VS Code 检测到的键盘快捷键以及调用的命令。

例如，当cmd+/在 macOS 上按下代码编辑器时，日志输出将为：

第一个 keydown 事件针对MetaLeft( cmd) 键，无法调度。第二个 keydown 事件针对Slashkey ( /)，并作为 进行调度meta+[Slash]。有两个映射的键绑定条目meta+[Slash]，匹配的一个是用于 command 的editor.action.commentLine，它具有when条件editorTextFocus && !editorReadonly并且是一个内置的键绑定条目。

您可以使用“更多操作” ( ... ) 菜单中的“显示用户键绑定”命令在键盘快捷键编辑器中查看 VS Code 中任何用户修改的键盘快捷键。这会将过滤器应用到键盘快捷键编辑器（源为“用户”）。@source:user

VS Code 中的所有键盘快捷键都可以通过该文件进行自定义keybindings.json。

您还可以使用“首选项：打开键盘快捷键 (JSON)”keybindings.json命令从命令面板 ( ⇧⌘P (Windows、Linux Ctrl+Shift+P ) ) 打开文件。

每条规则包括：

和弦（两个单独的按键操作）通过用空格分隔两个按键来描述。例如，Ctrl+K Ctrl+C。

当按下某个键时：

附加keybindings.json规则在运行时附加到默认规则的底部，从而允许它们覆盖默认规则。该keybindings.json文件由 VS Code 监视，因此在 VS Code 运行时对其进行编辑将在运行时更新规则。

键盘快捷键调度是通过分析以 JSON 表示的规则列表来完成的。这里有些例子：

key由修饰符和键本身组成。

接受以下修饰符：

接受以下键：

您可以使用参数调用命令。如果您经常对特定文件或文件夹执行相同的操作，这非常有用。您可以添加自定义键盘快捷键来完全执行您想要的操作。

以下是覆盖Enter键以打印一些文本的示例：

type 命令将接收{"text": "Hello World"}作为其第一个参数，并将“Hello World”添加到文件中，而不是生成默认命令。

有关带参数的命令的更多信息，请参阅内置命令。

可以使用该命令创建一个连续运行多个其他命令的键绑定runCommands。

请注意，运行的命令runCommands接收 的值"args"作为第一个参数。因此，在上面的示例中，workbench.action.files.newUntitledFile接收{"languageId": "typescript" }作为其第一个也是唯一的参数。

要传递多个参数，需要将其"args"作为数组：

要将数组作为第一个参数传递，需要将该数组包装在另一个数组中："args": [ [1, 2, 3] ]。

您可以编写以删除特定默认键绑定为目标的键绑定规则。使用keybindings.json，总是可以重新定义 VS Code 的所有键绑定，但进行小的调整可能很困难，特别是围绕重载的键，例如Tab或Escape。要删除特定的键绑定，请添加 ，-该command规则将成为删除规则。

这是一个例子：

要使用空操作覆盖特定的键绑定规则，您可以指定一个空命令：

注意：本节仅涉及按键绑定，与编辑器中的输入无关。

上面的键是虚拟键的字符串表示形式，不一定与按下它们时产生的字符相关。更确切地说：

不同的键盘布局通常会重新定位上述虚拟键或更改按下这些虚拟键时产生的字符。当使用与标准美国不同的键盘布局时，Visual Studio Code 会执行以下操作：

所有键绑定均使用当前系统的键盘布局在 UI 中呈现。例如，Split Editor当使用法语（法国）键盘布局时，现在呈现为Ctrl+*：

编辑时keybindings.json，VS Code 会突出显示误导性的键绑定，这些键绑定在文件中表示为在标准美国键盘布局下生成的字符，但需要在当前系统的键盘布局下按下具有不同标签的键。例如，以下是使用法语（法国）键盘布局时默认键盘快捷键规则的样子：

还有一个小部件可以帮助在编辑时输入按键绑定规则keybindings.json。要启动“定义键绑定”小部件，请按⌘K ⌘K（Windows、Linux Ctrl+K Ctrl+K）。该小部件侦听按键并在文本框及其下方呈现序列化的 JSON 表示形式，即 VS Code 在当前键盘布局下检测到的按键。输入所需的组合键后，您可以按Enter 键，然后将插入规则片段。

注意：在 Linux 上，Visual Studio Code 在启动时检测当前的键盘布局，然后缓存此信息。为了获得良好的体验，如果您更改键盘布局，我们建议您重新启动 VS Code。

使用扫描码，可以定义不随键盘布局的变化而变化的键绑定。例如：

接受扫描码：

VS Code 使您可以通过可选子句精细控制何时启用键绑定when。如果您的键绑定没有when子句，则键绑定始终全局可用。子句when的计算结果为布尔值 true 或 false 以启用键绑定。

VS Code 根据 VS Code UI 中可见和活动的元素设置各种上下文键和特定值。例如，内置的“开始调试”命令具有键盘快捷键F5，仅当有适当的调试器可用（上下文debuggersAvailable为 true）并且编辑器不处于调试模式（上下文inDebugMode为 false）时才启用该快捷键：

您还可以直接在默认键绑定 JSON 中查看键绑定的 when 子句（首选项：打开默认键盘快捷键 (JSON)）：

对于when子句条件表达式，以下条件运算符对于键绑定很有用：

您可以在when 子句上下文参考中找到when 子句条件运算符的完整列表。

您可以在when 子句上下文参考中找到一些可用的when子句上下文。

该列表并不详尽，您可以通过在键盘快捷键编辑器中搜索和过滤（首选项：打开键盘快捷键）或查看默认键绑定 JSON 文件（首选项：打开默认键盘快捷键 (JSON)when ）来查找其他子句上下文。

该editor.action.codeAction命令允许您为特定重构（代码操作）配置键绑定。例如，下面的键绑定会触发Extract 函数重构代码操作：

重构主题对此进行了深入介绍，您可以在其中了解不同类型的代码操作以及如何在多个可能的重构情况下确定它们的优先级。

您可以使用“更多操作” ( ... ) 菜单中的“显示默认键绑定”命令在键盘快捷键编辑器中查看 VS Code 中的所有默认键盘快捷键。这会将过滤器应用到键盘快捷键编辑器（源为“默认”）。@source:default

您可以使用命令Preferences: Open Default Keyboard Shortcuts (JSON)以 JSON 文件形式查看默认键盘快捷键。

注意：以下键是假设标准美国键盘布局呈现的。如果您使用不同的键盘布局，请阅读以下内容。您可以在命令面板（查看->命令面板）或键盘快捷键编辑器（文件>首选项>键盘快捷键）中查看 VS Code 中当前活动的键盘快捷键。

下面包含的一些命令没有默认键盘快捷键，因此显示为未分配，但您可以分配自己的键绑定。

现在您已经了解了我们的按键绑定支持，下一步是什么......

在键盘快捷键编辑器中，您可以过滤特定的击键以查看哪些命令绑定到哪些键。下面您可以看到Ctrl+Shift+P绑定到“显示所有命令”以调出命令面板。

在默认键盘快捷键中找到触发操作的规则，并将其修改版本写入您的keybindings.json文件中：

editorLangId在子句中使用上下文键when：

最常见的问题是文件中的语法错误。否则，请尝试删除该when子句或选择不同的key. 不幸的是，目前这是一个反复试验的过程。