VS Code快捷键绑定高级技巧：when子句的使用

通过 when 子句可实现 VS Code 快捷键的情境化控制，1. 利用 editorTextFocus、editorLangId 等条件限定触发环境，2. 结合逻辑运算符组合条件，3. 在 keybindings.json 中配置差异化行为，4. 使用 Developer: Inspect Context Keys 调试上下文状态，使快捷键按场景智能生效。

在 VS Code 中，快捷键的自定义不仅限于简单的键位映射，通过 when 子句 可以实现高度情境化的快捷键控制。它允许你根据编辑器当前的状态决定某个快捷键是否生效，从而避免冲突、提升效率。

理解 when 子句的作用

when 子句是 VS Code 键盘快捷方式中的条件表达式。只有当指定条件为真时，绑定的快捷键才会触发。这让你可以在不同上下文中复用相同的按键组合，而不会产生干扰。

例如，你想让 Ctrl+Enter 在普通编辑时插入新行，但在调试控制台中发送代码，就可以通过不同的 when 条件来区分行为。

常见 context 条件关键词

VS Code 提供了大量内置的上下文变量（context），用于构建 when 表达式。以下是一些高频使用的条件：

• editorTextFocus：当前焦点在文本编辑器中
• textInputFocus：焦点在可输入文本的控件中（如搜索框）
• editorHasSelection：编辑器中有选中文本
• editorLangId == 'python'：当前编辑的是 Python 文件
• inDebugRepl：处于调试控制台环境
• sidebarFocus：侧边栏获得焦点
• panelFocus：底部面板获得焦点

这些条件可以组合使用，支持逻辑运算符：

• AND：&&
• OR：||
• NOT：!

实用配置示例

打开 keybindings.json（通过命令面板执行 “Preferences: Open Keyboard Shortcuts (JSON)”）进行高级编辑。以下是几个典型场景：

小鸽子助手

一款集成于WPS/Word的智能写作插件

55

查看详情

1. 仅在 Python 文件中启用特定快捷键

[
  {
    "key": "ctrl+shift+r",
    "command": "python.refactor.extractVariable",
    "when": "editorTextFocus && editorLangId == 'python'"
  }
]

2. 区分普通编辑与调试控制台中的回车行为

[
  {
    "key": "ctrl+enter",
    "command": "extension.sendToTerminal",
    "when": "inDebugRepl"
  },
  {
    "key": "ctrl+enter",
    "command": "editor.action.insertLineAfter",
    "when": "editorTextFocus && !inDebugRepl"
  }
]

3. 有选中内容时才触发格式化

[
  {
    "key": "cmd+k cmd+f",
    "command": "editor.action.formatSelection",
    "when": "editorHasSelection && editorTextFocus"
  }
]

如何查看当前上下文状态

调试 when 条件时，可通过命令面板运行 Developer: Inspect Context Keys。启动后，鼠标移动或操作界面时会实时显示所有当前为真的 context 值，极大方便规则编写。

基本上就这些。掌握 when 子句后，你可以让快捷键真正“智能”起来，贴合你的工作流细节，而不是生硬地全局生效。

以上就是VS Code快捷键绑定高级技巧：when子句的使用的详细内容，更多请关注php中文网其它相关文章！