Sublime Text 快捷键失效主因是后加载绑定静默覆盖、系统/输入法劫持或 JSON 语法错误；需用 sublime.log_input(True) 确认按键是否到达，按加载顺序排查 Default→插件→User，并统一使用 super 键名跨平台。
Sublime Text 的快捷键冲突不是配置没生效，而是你写的那条根本没机会执行——它被后加载的绑定静默覆盖了。
怎么确认按键到底进没进 Sublime
这是所有排查的第一步。按 Ctrl+` 打开控制台，输入 sublime.log_input(True) 回车，再按你想查的组合键（比如 Ctrl+/ 或 Cmd+Shift+P）。
- 如果控制台完全没输出，说明系统、输入法或显卡驱动在中途截断了信号——Sublime 根本没看到这个键
- Windows 用户重点检查 NVIDIA 控制面板「热键」、Intel Graphics Command Center「快捷键」、搜狗/QQ 拼音默认占用的
Ctrl+Shift类组合 - macOS 用户注意系统设置 → 键盘 → 快捷键 →「Spotlight」和「输入源」是否占用了
Cmd+Space或Cmd+Shift+P - 未勾选「使用 F1、F2 等键作为标准功能键」时，
Esc可能被键盘固件吞掉
为什么改了 User.sublime-keymap 还是无效
Sublime 加载顺序是：Default → 插件自带的 Default.sublime-keymap → User.sublime-keymap。后加载的条目会静默覆盖前一个，不报错也不提示。
- 按
Ctrl+Shift+P输入Preferences: Key Bindings，左右并排打开 Default 和 User 文件 - 在左侧 Default 中搜索目标组合（如
"ctrl+d"），确认它原本应触发什么命令（如duplicate_line） - 在右侧 User 和所有插件目录（
Packages/Vintage/、Packages/Emmet/等）中全局搜索相同"keys"字段 - 高危插件优先排查：
Vintage、Emmet、Origami、GitGutter
User.sublime-keymap 写错 JSON 就等于没写
这个文件是纯 JSON 数组，语法错一点整份配置就被 Sublime 静默忽略——右下角可能只闪一下红字错误提示，稍不注意就错过。
- 所有键名和字符串值必须用英文双引号包裹，
"keys"不是keys，"toggle_comment"不是toggle_comments - 数组结尾不能多逗号：
["ctrl+alt+f"],是错的，["ctrl+alt+f"]才对 - 不支持
//注释；想临时禁用某条绑定，要么删整行，要么改成无效命令："command": "not_a_real_command" - 保存后立即生效，无需重启，但必须确保没其他插件在更靠后的位置又绑了一次
跨平台键位映射别直接复制粘贴
macOS 的 super 对应 Windows/Linux 的 ctrl，但反过来不成立。Sublime 内部用 super 表示 macOS 的 Command 键、Windows/Linux 的 Ctrl 键——这是唯一跨平台语义键名。
- 错误写法（会导致 macOS 失效）：
{"keys": ["ctrl+shift+f"], "command":"show_panel", "args": {"panel":"find"}} - 正确写法（三端自动映射）：
{"keys": ["super+shift+f"], "command":"show_panel", "args": {"panel":"find"}} - 不要在
User.sublime-keymap里硬写cmd或ctrl，一律用super -
Esc键关不了命令面板？别碰 Key Bindings——它是内核硬编码行为，你加的绑定不仅无效，还会破坏原生逻辑
真正容易被忽略的是 context 字段：同一按键在不同上下文（如 "key": "setting.is_widget"）可能绑定不同行为，表面没冲突，实则“条件性失效”。排查时得连 "context" 一起看，否则改了也白改。
