VSCode右键菜单通过“when”条件实现情境感知，根据文件类型、选中状态等动态显示命令。例如，仅在JavaScript文件中显示“Log to Console”，或当文本被选中且为Markdown文件时显示“翻译选中内容”。通过resourceLangId、editorHasSelection等上下文变量控制显示逻辑，开发者可使用“Inspect Context Keys”调试，确保命令在合适场景展示，提升操作效率与用户体验。
VSCode 的上下文菜单（右键菜单）支持情境感知，能根据当前光标位置、文件类型、选中内容等动态显示相关命令。这种机制提升了操作效率，避免展示无效选项。
情境感知的工作原理
VSCode 通过“when”条件控制菜单项的显示逻辑。每个命令在注册时可绑定一个上下文表达式，仅当表达式为真时才出现在菜单中。
常见上下文变量包括：
- resourceScheme：判断文件协议（如 file、untitled）
- resourceLangId：当前文件语言类型（如 javascript、python）
- editorHasSelection：编辑器是否有文本被选中
- isInEmbeddedEditor：是否在内嵌编辑器中（如笔记本单元格）
- notebookType：特定于笔记本环境的上下文
实际应用场景示例
以扩展开发为例，若只希望在 JavaScript 文件中显示“Log to Console”命令：
"menus": { "editor/context": [ { "command": "extension.logToConsole", "when": "resourceLangId == javascript" } ] }
又比如，仅当用户选中文本时才显示“翻译选中内容”：
"when": "editorHasSelection && resourceLangId == markdown"调试与验证技巧
若菜单项未按预期显示，可通过以下方式排查：
- 打开命令面板执行 Developer: Inspect Context Keys，实时查看当前上下文变量值
- 检查 when 表达式拼写和大小写（变量名区分大小写）
- 确认命令是否正确注册到目标菜单分组（如 editor/context、explorer/context）
- 测试不同场景（空文件、有选中、不同语言）观察行为变化
基本上就这些。掌握上下文条件配置，能让扩展更贴合用户操作习惯，减少干扰。
