唯一可信的快捷键调试方式是启用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 环境中生效。