VSCode插件快捷键需手动配置才能稳定生效，关键在查改绑定、写准when条件、排查系统/输入法/插件拦截三层障碍。
VSCode 的插件快捷键不是“装上就自动好用”的，它们默认可能冲突、不生效，甚至被系统或其它扩展悄悄吃掉——关键不在“有没有”，而在“怎么让它们稳定触发”。
插件自带的快捷键在哪查、怎么改
很多插件（比如 GitLens、Vim、Prettier）安装后会立刻注册一堆快捷键，但你未必知道它们绑了什么。最准的方式是打开 Ctrl+K Ctrl+S，在搜索框里输插件名（如 gitlens 或 prettier），所有相关绑定都会列出来，来源栏标着 “Extension”。
- 想改某条：右键 → “更改键绑定”，然后按新组合键；若标红，说明已被占用
- 想禁用某条又怕影响插件功能：右键 → “清除键绑定”，它会在
keybindings.json里写一条{"key": "", "command": "-"}，比删配置安全 - 别直接去插件文档抄快捷键——不同版本、不同平台（比如 macOS 的
Cmdvs Windows 的Ctrl）可能有差异
自定义快捷键时 when 条件必须写对
光写 "key": "ctrl+alt+f" 和 "command": "editor.action.formatDocument" 不够。如果没加 when，这个快捷键可能在终端、搜索面板、设置页里也响应，导致误触发或静默失败。
- 常见条件值：
editorTextFocus（仅编辑器有焦点时）、editorLangId == 'javascript'（仅 JS 文件）、terminalFocus（终端聚焦时） - 多个条件用
&&连接，比如："when": "editorTextFocus && editorLangId == 'typescript' - 条件写错不会报错，只是“按了没反应”——这是最常被忽略的调试盲区
为什么改了快捷键还是不生效
90% 的“不生效”问题和 JSON 写法无关，而是被更高优先级的拦截层挡住了。
- 系统级热键（如
Alt+F4、Ctrl+Shift+T）VSCode 根本收不到，强行绑定等于空转 - 输入法或外设软件（搜狗拼音、Logitech Options、Raycast）常劫持
Ctrl+;、Ctrl+Shift+P等组合，临时退出它们再试一次，比重配十次更有效 - Vim / Emacs 扩展默认接管全部键盘行为，哪怕你只开了普通模式，也要检查它的“disable key bindings”设置项
- 非美式键盘用户注意：
Ctrl+;在中文输入法下常被识别为Ctrl+:，需在settings.json中加"keyboard.dispatch": "keyCode"强制按物理键位处理
真正难的不是加一条快捷键，而是让它在所有上下文里都稳定、可预期地工作——尤其当多个插件叠加、跨平台协作、输入法混用时，when 条件、系统拦截、插件抢占这三层得逐层确认，漏掉一层就白配。
