唯一可信的快捷键调试方法是启用sublime.log_input(true)和sublime.log_commands(true),通过控制台日志判断按键是否被系统截断、绑定是否被覆盖或命令名拼错,而非依赖keymaps插件列出的绑定。

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 里的条目,插件那条仍生效
临时验证方法:运行 subl --safe-mode,如果快捷键恢复,就坐实是插件冲突;再用 Package Control: Disable Package 逐个关,不用猜。
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 键根本不在 keymap 流程里
关闭命令面板、搜索框、替换栏这些行为是 Sublime 内核硬编码逻辑,不走任何 .sublime-keymap 文件。
- 你在
User.sublime-keymap里加{"keys": ["escape"], "command": "hide_panel"}不仅无效,还会破坏原生逻辑(比如按 Esc 后面板卡住不隐藏) - Esc 失效时,先跑
subl --safe-mode:若恢复,说明是插件劫持(Vintage 的exit_insert_mode_on_escape、Origami 的close_on_escape都可能干扰) - 若安全模式下仍无效,且
sublime.log_input(True)无输出,问题在 macOS 未勾选「使用 F1、F2 等键作为标准功能键」,或键盘固件层拦截
context 条件、动态绑定、内核硬编码——这些才是最容易被忽略的复杂点,日志和加载顺序是唯二可依赖的锚点。











