Sublime Text快捷键“按了没反应”，90%是按键未进入编辑器或被后加载插件静默覆盖；需先用sublime.log_input(True)确认输入是否送达，再按Default→插件Default→User顺序排查绑定冲突及JSON语法错误。
Sublime Text 快捷键“按了没反应”，90% 不是配置错了，而是按键压根没进编辑器，或被后加载的插件静默覆盖——改 User.sublime-keymap 前不排查这两点，等于白调。
怎么确认按键是否真的进了 Sublime？
这是所有排查的第一步。按 Ctrl+` 打开控制台，输入 sublime.log_input(True) 回车，再按你怀疑失效的组合键（比如 Ctrl+Shift+P、Esc、Ctrl+/）。
- 控制台完全没输出 → 按键被系统/驱动/输入法截断：Windows 查 NVIDIA 控制面板或 Intel Graphics Command Center 的热键；macOS 查「系统设置 → 键盘 → 快捷键 → 输入源」是否占用了同名组合
- 有输出（如
key evt: ctrl+shift+p）→ 按键已送达，问题在 Sublime 内部绑定层
为什么改了 User.sublime-keymap 还是无效？
因为 Sublime 加载快捷键的顺序是：Default → 插件自带的 Default.sublime-keymap → User.sublime-keymap。后加载者直接覆盖前一个，且不报错。
- 按
Ctrl+Shift+P输入Preferences: Key Bindings，左右并排打开两个文件 - 在左侧（Default）搜索目标组合，比如
"ctrl+/"，确认它原本对应toggle_comment - 在右侧（User）和所有插件目录（
Packages/Vintage/、Packages/Emmet/等）中全局搜索同一"keys"字段 - 高危插件优先排查：
Vintage、Emmet、Origami、GitGutter
User.sublime-keymap 写错 JSON 就等于没写
这个文件是纯 JSON 数组，语法错一点整份配置就被静默忽略。右下角红字提示一闪而过，极易错过。
- 所有键名和字符串值必须用英文双引号包裹：
"keys"不是keys，"toggle_comment"不是toggle_comments - 数组结尾不能多逗号：
["ctrl+alt+f"],是错的，["ctrl+alt+f"]才对 - 不支持
//或/* */注释；想临时禁用某条绑定，要么删整行，要么改成无效命令："command": "not_a_real_command" - 改完必须按
Ctrl+S保存，Sublime 会立即重载，但若插件的Default.sublime-keymap里也有相同keys且加载更晚，你的自定义仍会被盖掉
Esc、Tab 这类键根本不在 .sublime-keymap 管辖范围内
Esc 关搜索框、关命令面板、关替换栏，是 Sublime 内核硬编码行为，不走任何 keymap 流程。你在 User.sublime-keymap 里加 {"keys": ["escape"], "command": "hide_panel"} 不仅无效，还会破坏原生逻辑。
- 若
Esc失效，先运行subl --safe-mode：如果此时恢复，说明是插件劫持（常见于Vintage、Origami） -
Vintage需进Preferences → Package Settings → Vintage → Settings，设"exit_insert_mode_on_escape": false -
Origami则关掉其close_on_escape选项 - 若
--safe-mode下仍无效，且sublime.log_input(True)无输出，问题可能出在 macOS 未勾选「使用 F1、F2 等键作为标准功能键」，或键盘固件层吞掉了信号
真正卡住人的地方，往往不是“怎么加新快捷键”，而是“为什么旧的不生效”——尤其当 Esc 和 Tab 这类基础键也失灵时，说明问题已脱离 keymap 层，进入插件上下文或系统事件分发环节。
