VSCode上下文密钥_条件表达式与when子句

上下文密钥是VSCode中用于控制UI行为的布尔状态标志，如editorTextFocus、resourceLangId等，可在when子句中通过逻辑与比较操作精确控制命令、菜单和快捷键的显示与启用条件，结合Developer: Inspect Context Keys可实时调试，对扩展开发和个性化配置至关重要。

在 Visual Studio Code（VSCode）中，上下文密钥（context keys） 是控制 UI 行为和命令可用性的核心机制之一。它们常用于 when 子句中，决定菜单项、快捷键、按钮等是否显示或启用。理解上下文密钥与条件表达式的使用方式，对自定义编辑器行为或开发扩展非常关键。

什么是上下文密钥？

上下文密钥是布尔值的状态标志，表示当前编辑器或应用所处的某种“上下文”。例如，某个文件是否已聚焦、是否有选中文本、当前语言模式是什么等。这些密钥在运行时动态更新，开发者可在配置中通过 when 条件判断其真假。

常见的上下文密钥包括：

• editorTextFocus：文本编辑器获得焦点
• editorHasSelection：编辑器中存在文本选择
• inQuickOpen：正在使用快速打开面板
• terminalFocus：终端获得焦点
• resourceLangId == 'python'：当前文件是 Python 类型

when 子句中的条件表达式

when 子句出现在 package.json 的命令、菜单、键绑定等配置中，用于指定某项功能何时生效。它支持逻辑运算和比较操作。

基本语法示例：

• editorTextFocus && !editorHasSelection：编辑器有焦点且无选中文本
• terminalFocus || outputFocus：终端或输出面板获得焦点
• resourceLangId == 'markdown'：当前文件是 Markdown 类型
• config.editor.tabSize == 4：编辑器 tabSize 配置为 4

支持的操作符：

• 逻辑：&&（与）、||（或）、!（非）
• 比较：==、!=、<、<=、>、>=
• 字符串、数字、布尔类型均可参与比较

如何查看当前上下文密钥状态

调试 when 条件时，可通过命令面板执行 Developer: Inspect Context Keys 命令。它会打开一个实时视图，列出所有当前激活的上下文密钥及其值，方便验证条件是否满足。

DeepBrain

AI视频生成工具，ChatGPT +生成式视频AI =你可以制作伟大的视频!

94

查看详情

这个工具对扩展开发者尤其有用，能快速定位为何某个菜单项未显示或快捷键未生效。

在扩展开发中的实际应用

假设你开发一个扩展，希望只在 JavaScript 文件中显示某个命令：

或者你想让快捷键仅在没有选中文本时生效：

合理组合上下文密钥可实现精细的用户交互控制。

基本上就这些。掌握上下文密钥和 when 条件表达式，能让 VSCode 的自定义能力大幅提升，无论是写扩展还是调整个性化设置都很实用。

以上就是VSCode上下文密钥_条件表达式与when子句的详细内容，更多请关注php中文网其它相关文章！