Sublime Text快捷键失效90%是信号未送达：先用sublime.log_input(True)验证控制台有无输出，无输出则被系统/输入法/驱动截断；有输出说明绑定层问题，需检查插件覆盖、JSON语法错误及内核硬编码键限制。
确认按键是否真正进入 Sublime Text
快捷键没反应，90% 的情况是 Sublime 根本没收到这个键——不是配置错了，是它压根没进来。先别改 User.sublime-keymap，直接验证信号链：按 Ctrl+` 打开控制台，输入 sublime.log_input(True) 回车，再按你怀疑失效的组合（比如 Cmd+Shift+P 或 Ctrl+/）。如果控制台完全没输出，说明被系统/输入法/显卡驱动截断了。
- macOS 用户重点检查：
系统设置 → 键盘 → 快捷键 → 输入源中是否启用了Cmd+Space或Cmd+Shift+P作为切换输入法的快捷键 - Windows 用户检查 NVIDIA 控制面板或 Intel Graphics Command Center 里的热键设置，以及搜狗/QQ 拼音默认占用的
Ctrl+Shift - 临时切到系统自带「简体中文-拼音」或英文输入法测试，若恢复即锁定为第三方输入法劫持
排查插件对快捷键的静默覆盖
如果 sublime.log_input(True) 有输出（例如 key evt: ctrl+/），说明按键已送达，问题出在绑定层。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、SideBarEnhancements - 临时验证：用
Package Control: Disable Package逐个禁用，或命令行启动subl --safe-mode；若此时快捷键恢复，就坐实是插件干扰
修正 User.sublime-keymap 的 JSON 格式错误
User.sublime-keymap 是纯 JSON 数组，语法错一点就会被 Sublime 静默忽略——右下角红字提示一闪而过，极易错过。这不是“没生效”，是“根本没被解析”。
- 所有键名和字符串值必须用英文双引号包裹：
"keys"不是keys，"toggle_comment"不是toggle_comments - 数组结尾不能多逗号：
["ctrl+alt+f"],是错的，["ctrl+alt+f"]才对 - 不支持
//或/* */注释；想临时禁用某条绑定，要么删整行，要么改成无效命令："command": "not_a_real_command" - 保存后立即生效，无需重启；但若某个插件的
Default.sublime-keymap里也有同keys且加载更晚，你的自定义仍会被盖掉
避开内核硬编码键的修改陷阱
Esc、Tab、Cmd+B 这些行为由 Sublime 内核硬编码实现，不走任何 .sublime-keymap 流程。你在 User.sublime-keymap 里加 {"keys": ["escape"], "command": "hide_panel"} 不仅无效，还会破坏原生逻辑。
-
Esc失效时，先运行subl --safe-mode：若恢复，说明是插件劫持（常见于Vintage或Origami） -
Cmd+B在 macOS 上常被 Finder 或 Dock 占用，应去系统设置 → 键盘 → 快捷键 → 应用快捷键中搜索并删除重复项 - 像
Cmd+Shift+P这类与 Spotlight 冲突的组合，不要禁用系统功能，而是改用Ctrl+Shift+P或Cmd+Alt+P并在User.sublime-keymap中显式绑定
真正卡住的地方往往不在配置本身，而在你没意识到的拦截层级——系统快捷键、输入法热键、显卡驱动、插件加载顺序、JSON 语法细节，每一层都可能让修改看起来“没用”。验证信号是否进得来，比急着改绑定重要得多。
