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 命令创建自定义状态。比如你在开发一个插件，可以动态设置一个上下文标志：
然后在快捷键中引用它，实现仅在调试模式下启用某些操作。
这适合高级用户或插件开发者，能极大增强自动化能力。
调试 when 表达式的小技巧
when 子句不生效？试试这些方法：
- 打开命令面板，运行 “Developer: Inspect Context Keys” 查看当前所有激活的上下文状态
- 检查拼写，大小写敏感，且不能有语法错误
- 避免使用已弃用的上下文名称（参考官方文档）
- 优先使用精确条件，避免过于宽泛导致冲突
基本上就这些。理清逻辑关系，善用上下文组合，你的快捷键就能像条件语句一样精准执行。不复杂但容易忽略。
