真正生效的VSCode快捷键配置必须编辑keybindings.json:通过Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)运行“Preferences: Open Keyboard Shortcuts (JSON)”,在空数组中添加含key、command及可选when字段的合法JSON对象,key须小写无空格、修饰键顺序固定,command须为完整命令ID,when不匹配将导致静默失效,冲突靠数组顺序覆盖,禁用需加负号前缀。

直接改 keybindings.json 才真正生效
GUI 界面(Ctrl+K Ctrl+S)点来点去只能临时增删,一装新插件、一升级 VSCode,就可能被覆盖或失效。真正稳定、可同步、带条件控制的修改,必须编辑 keybindings.json 文件。
别手动找路径或复制粘贴——90% 的“改了没反应”都源于此。正确做法是:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Preferences: Open Keyboard Shortcuts (JSON) 回车。VSCode 会自动打开用户级配置文件,初始内容就是空数组 [],所有自定义项必须作为对象写在里面。
-
key必须小写、无空格;修饰键顺序固定为ctrl→shift→alt→meta(macOS 用cmd);例如"ctrl+alt+/"✅,"Ctrl+Alt+/"❌ -
command必须是完整命令 ID,不是中文名;可在 GUI 中悬停快捷键,看 tooltip 显示的字符串,比如editor.action.blockComment,不是 “切换块注释” - 字母键默认小写;想触发大写需显式加
shift,如"ctrl+shift+u"绑的是Ctrl+Shift+U
改单行/块注释快捷键,先禁用默认绑定再重绑
直接新增一条 {"key":"ctrl+alt+/","command":"editor.action.blockComment"} 很可能没反应——因为默认的 Ctrl+/ 还占着位,且插件(如 Vim、GitLens)可能已劫持该组合。安全做法是先明确禁用旧绑定,再绑定新键。
在 keybindings.json 中写:
[{"key":"ctrl+/","command":"-editor.action.lineComment"},{"key":"ctrl+alt+/","command":"editor.action.blockComment"}]注意:- 必须紧挨着命令名,不能有空格;也不能写成 "- editor.action.lineComment",否则无效。这条的意思是:释放 Ctrl+/,后续才能放心绑定新命令。
- 命令 ID 可在 GUI 中右键某条快捷键 → “复制命令 ID” 获取
- 单行注释对应命令是
editor.action.lineComment,块注释是editor.action.blockComment - 非美式键盘(如中文输入法下
Ctrl+;常被识别成Ctrl+:)需额外处理,但注释类快捷键一般不受影响
when 条件漏写,快捷键就静默失效
很多用户加完键发现“按了没反应”,不是配置错,而是 when 条件不满足。VSCode 不报错、不提示,直接忽略——这是最隐蔽的坑。
比如你想让 Ctrl+Alt+/ 只在编辑器里生效,就得加上:
{"key":"ctrl+alt+/","command":"editor.action.blockComment","when":"editorTextFocus"}否则它可能在终端、资源管理器甚至设置页里也尝试触发,结果失败静默。
-
"when": "editorTextFocus":仅当编辑器获得焦点时生效 -
"when": "editorTextFocus && resourceExtname == '.py'":只在 Python 文件中生效 - 完全放开限制可删掉
when字段(等价于true),但容易误触,不推荐
插件抢键、系统拦截,比配置错误更常见
快捷键没反应,80% 不是 JSON 写错了,而是被第三方吃掉了。查占用最准的方式是打开 GUI 快捷键面板(Ctrl+K Ctrl+S),搜你的组合键,看“来源”列是 Default、Extension 还是 User。
常见干扰源:
- GitLens、Vim 扩展自带大量绑定,优先级高于用户配置
- 搜狗拼音、Logitech Options、Raycast 等工具常偷偷吞掉
Ctrl+Shift+P或Ctrl+;类组合 - Linux 下
Ctrl+Alt+T默认唤起终端,VSCode 根本收不到
临时退出这些软件再试一次,比重配十次更有效。如果确认是插件冲突,可在 GUI 中右键该快捷键 → “禁用此扩展的快捷键”。
跨平台同步时,统一用 ctrl 前缀即可,VSCode 会自动映射为 macOS 的 cmd;若需平台特异逻辑,用 when: "isMac" 或 when: "isWindows" 控制。


















