VS Code的高级快捷键绑定：when子句逻辑

VS Code 快捷键的 when 子句用于条件触发，仅当表达式为真时生效；它基于编辑器状态（如 editorTextFocus、editorHasSelection、editorLangId 等）进行判断，支持逻辑运算与自定义上下文，配合调试技巧可实现精准控制。

VS Code 的快捷键系统非常灵活，关键在于 when 子句的使用。它决定了某个快捷键在什么条件下生效。掌握其逻辑，能让你的键位绑定更智能、更精准。

理解 when 子句的作用

when 子句是 VS Code 快捷键规则中的条件判断部分。只有当表达式为真时，快捷键才会触发。它基于编辑器当前的状态，比如焦点在哪个区域、语言模式、是否有选中内容等。

例如，你可能希望某个快捷键只在终端打开时生效，或仅在代码有选中时才运行格式化命令。这些都靠 when 表达式控制。

常用上下文条件与逻辑组合

VS Code 提供多个内置上下文变量，可组合出复杂逻辑：

• editorTextFocus：光标在编辑器文本中（非侧边栏、搜索框等）
• terminalFocus：焦点在集成终端
• textInputFocus：任意输入框获得焦点
• editorHasSelection：编辑器中有文本被选中
• editorLangId == 'python'：当前语言为 Python
• inQuickOpen：正在使用快速打开面板（Ctrl+P）

你可以用 &&（与）、||（或）、!（非）进行组合。

例如：
editorTextFocus && editorHasSelection && editorLangId == 'javascript'
表示：仅当在 JavaScript 文件中且有文本选中时生效。

自定义上下文提升控制力

如果内置条件不够，可用扩展或 setContext 命令创建自定义状态。比如你在开发一个插件，可以动态设置一个上下文标志：

myExtension.inDebugMode == true

然后在快捷键中引用它，实现仅在调试模式下启用某些操作。

这适合高级用户或插件开发者，能极大增强自动化能力。

调试 when 表达式的小技巧

when 子句不生效？试试这些方法：

• 打开命令面板，运行 “Developer: Inspect Context Keys” 查看当前所有激活的上下文状态
• 检查拼写，大小写敏感，且不能有语法错误
• 避免使用已弃用的上下文名称（参考官方文档）
• 优先使用精确条件，避免过于宽泛导致冲突

基本上就这些。理清逻辑关系，善用上下文组合，你的快捷键就能像条件语句一样精准执行。不复杂但容易忽略。