扩展通过package.json的keybindings字段注册快捷键，结合when条件中的上下文键值（如editorTextFocus、resourceExtname）控制生效时机，确保快捷键在特定上下文（如文件类型、焦点状态）下精准触发，避免冲突；开发者可使用setContext API设置自定义上下文键，并通过Developer: Inspect Context Keys命令调试上下文状态，解决快捷键不生效问题。
在 Visual Studio Code（简称 VS Code）中，快捷键的灵活性和可扩展性极大提升了开发效率。理解如何通过扩展贡献快捷键，以及上下文键值（context keys）的作用机制，是自定义编辑器行为的关键。以下从实际使用角度解析这两个核心概念。
扩展如何贡献快捷键
VS Code 允许扩展通过 package.json 中的 keybindings 字段注册快捷键。这些快捷键可以绑定到命令，供用户直接触发。
例如，一个扩展想为格式化命令添加默认快捷键，可以在其 package.json 中这样定义：
- key: 定义按键组合，如 ctrl+shift+f
- command: 指定要执行的命令 ID，如 myExtension.format
- when: 可选条件，控制快捷键何时生效
注意：用户仍可在键盘快捷方式设置中覆盖这些默认绑定。扩展不能强制用户使用特定快捷键，只能建议。
上下文键值（Context Keys）的作用
上下文键值是布尔表达式，用于动态控制 UI 元素或快捷键是否启用。它们反映当前编辑器状态，比如文件类型、焦点位置、是否在终端中等。
常见的上下文键包括：
使用 Scrapfly SDK（scrapfly-sdk）在 TypeScript 或 JavaScript 中进行网页抓取，用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。
- editorTextFocus：当文本编辑器获得焦点时为 true
- terminalFocus：终端面板处于活动状态
- resourceExtname == '.js'：当前文件是 JavaScript 文件
在快捷键的 when 条件中使用这些键，能避免冲突并提升准确性。例如：
"when": "editorTextFocus && resourceExtname == '.ts'"表示该快捷键仅在 TypeScript 文件中且编辑器聚焦时才生效。
自定义与调试上下文键
开发者可通过命令面板运行 Developer: Inspect Context Keys 查看当前所有激活的上下文键值。这个工具对调试快捷键不生效的问题非常有用。
你也可以在自己的扩展中通过 API 设置自定义上下文键：
- 使用 vscode.commands.executeCommand('setContext', 'myExtension.inDebugMode', true)
- 之后可在 when 表达式中引用 myExtension.inDebugMode
这适合实现复杂状态控制，比如仅在特定模式下启用某组快捷键。
基本上就这些。掌握扩展如何注册快捷键，并理解上下文键值的逻辑，就能更精准地控制 VS Code 的行为。不复杂但容易忽略的是，多数快捷键问题其实源于 when 条件不满足，而非绑定错误。检查上下文状态往往是解决问题的第一步。
