上下文条件式快捷键指在VSCode中通过when条件限定快捷键生效场景。例如，"editorTextFocus"确保快捷键仅在编辑器聚焦时触发，"editorHasSelection"使其仅在有选中文本时生效，避免与终端或调试面板冲突。用户可在keybindings.json中自定义如"ctrl+d"仅在可编辑文本区域生效，或"ctrl+shift+l"仅在选中文本时插入多光标。通过Developer: Inspect Context Keys可实时查看当前上下文状态，便于调试快捷键不响应问题，提升操作精准度与编辑效率。
VSCode 的快捷键系统支持基于上下文的条件式激活，这意味着某些快捷键只在特定条件下才会生效。这种机制避免了快捷键冲突，也提升了操作精准度。理解并合理利用这些上下文条件，能显著提高编辑效率。
什么是上下文条件式快捷键
VSCode 中的快捷键并非总是无条件触发。每个快捷键绑定都可以附加一个 when 条件，只有当该条件为真时，快捷键才被激活。这个条件通常与当前编辑器状态相关，比如光标位置、面板是否聚焦、文件类型等。
例如，按下 Ctrl+P 在编辑器中打开文件搜索，但如果焦点在调试控制台，这个快捷键可能无效——这就是上下文在起作用。
常见上下文条件关键词
这些是定义快捷键生效条件时常用的上下文键（context key），可在 keybindings.json 中使用：
- editorTextFocus：文本编辑器拥有焦点
- editorHasSelection：编辑器中有选中文本
- textInputFocus：任意输入框获得焦点（包括搜索框、终端等）
- sideBarFocus：侧边栏处于聚焦状态
- inDebugRepl：当前在调试控制台中
- notebookEditorFocused：笔记本编辑器被选中
- terminalFocus：终端面板正在使用
你可以通过命令面板执行 Developer: Inspect Context Keys 实时查看当前所有激活的上下文状态。
自定义条件式快捷键示例
打开 keybindings.json（菜单 → 文件 → 首选项 → 键盘快捷方式，然后点击右上角的“打开键盘快捷方式 (JSON)”图标），可以添加带条件的快捷键配置。
例如，只想在普通编辑器中启用某快捷键，而在终端中禁用：
{"key": "ctrl+d",
"command": "addNextOccurrence",
"when": "editorTextFocus && !editorReadonly"
}
这个设置确保 Ctrl+D 只在可编辑的文本区域生效，不会干扰终端中的输入。
另一个例子：让某个快捷键仅在有选中文本时才生效：
{"key": "ctrl+shift+l",
"command": "editor.action.insertCursorAtEndOfEachLineSelected",
"when": "editorHasSelection && editorTextFocus"
}
调试与验证快捷键上下文
当你发现某个快捷键没反应，很可能是 when 条件不满足。建议：
- 使用 Developer: Inspect Context Keys 查看当前上下文状态
- 在命令面板中尝试直接运行对应命令，确认功能本身正常
- 检查是否有其他扩展覆盖或屏蔽了该快捷键
- 临时移除
when条件测试快捷键是否生效
掌握上下文条件后，你不仅能更好理解默认快捷键的行为逻辑，还能创建更智能、更安全的自定义绑定。
