唯一可信的快捷键调试方式是启用sublime.log_input(true)和sublime.log_commands(true),二者分别验证按键是否被系统截断、是否触发命令,结合加载顺序(default→插件default→user)与json语法规范定位覆盖或失效原因。

sublime.log_input(True) 和 sublime.log_commands(True) 是唯一可信的入口
别信 Keymaps 插件列出的“全部绑定”,它漏掉动态注册、context 不匹配、系统级劫持的快捷键。真正能穿透所有层级的,只有 Sublime 自带的日志开关。
按 Ctrl+` 打开控制台,依次执行:
-
sublime.log_input(True)—— 按下快捷键,看是否有key evt: ctrl+shift+p类输出;没输出 = 键被系统/输入法/显卡驱动截断 -
sublime.log_commands(True)—— 再按同一组合,看是否出现command: show_panel {"panel": "console"};有输入无命令 = 绑定被覆盖或command名拼错
两者都无输出,问题不在 Sublime;只有前者有输出、后者无,说明按键进了编辑器但没触发有效命令;两者都有,再比对 command 名是否是你预期的(比如 toggle_comment 被替换成 emmet_expand_abbreviation)。
加载顺序决定谁赢:Default → 插件 Default → User
Sublime 不报错,也不提示覆盖,只按固定顺序加载并静默覆盖。你改的 User.sublime-keymap 并不是最终生效者。
- 左侧
Preferences > Key Bindings显示的是Default(系统默认),搜"ctrl+/"确认它本该调用toggle_comment - 右侧是
User,但必须去Packages/插件名/Default.sublime-keymap全局搜索同一"keys"字段——Vintage、Emmet、Origami这些插件常在这里偷偷绑定 - 插件的
Default.sublime-keymap加载在系统之后、User 之前,所以即使你删了 User 里的条目,插件那条仍生效
User.sublime-keymap 写错 JSON 就等于没写
这个文件是纯 JSON 数组,语法错一点整份配置就静默失效,右下角红字一闪而过,极易忽略。
- 必须用英文双引号:
"keys"不是keys,"command"不是command - 数组结尾不能多逗号:
["ctrl+alt+f"],是错的,["ctrl+alt+f"]才对 - 不支持
//或/* */注释;禁用某条绑定,要么删整行,要么改成"command": "not_a_real_command" - 常见低级错误:
toggle_comment写成toggle_comments、用中文引号、keys字段漏方括号
Esc、Tab、Cmd+Space 这些键根本不在 Key Bindings 管辖范围内
关闭搜索框、命令面板、替换面板这些行为是 Sublime 内核硬编码的,你往 User.sublime-keymap 里加 {"keys": ["escape"], "command": "xxx"} 不仅没用,还会破坏原生逻辑——比如按 Esc 后搜索框不关闭,面板也不隐藏,UI 就卡在那里。
类似地,Tab 是否展开 Emmet、Cmd+Space 是否唤出 Spotlight,都取决于 context 或系统设置,不是靠重写 keymap 就能绕过的。
真正容易被忽略的是:context 条件不满足时,哪怕 keymap 文件里明明白白写着绑定,也压根不会触发——比如 "context": [{"key": "setting.is_widget"}] 的规则,只在命令面板等 widget 环境中生效。











