先用sublime.log_input(True)确认按键是否进入Sublime:无输出说明被系统/输入法截断,有输出则按Default→插件→User顺序排查绑定覆盖及JSON语法错误。

Sublime Text 里快捷键“按了没反应”或“触发了错误命令”,基本不是配置写错了,而是你根本不知道谁在偷偷改绑定——得先揪出冲突源头,再动刀。
怎么确认按键进了 Sublime 还是被系统截胡?
别猜,用日志直接看信号路径:
- 按
Ctrl+`打开控制台,输入sublime.log_input(True)回车 - 再按你想查的组合键(比如
Ctrl+Shift+P或Cmd+D) - 如果控制台**完全没输出**,说明按键压根没进 Sublime:Windows 上可能是 NVIDIA 控制面板或 QQ 拼音劫持了
Ctrl+Shift;macOS 上大概率是「系统设置 → 键盘 → 快捷键 → 输入源」里把Cmd+Shift+P设成了切换输入法 - 如果有
key evt: ctrl+shift+p这类输出,说明按键已送达,问题出在 Sublime 内部绑定层
为什么改了 User.sublime-keymap 还是不生效?
Sublime 加载顺序是:Default → 插件的 Default.sublime-keymap → User。后加载者静默覆盖前一个,且不报错。
- 打开
Preferences → Key Bindings,左右并排看:左侧是只读的 Default,右侧是你能编辑的 User - 在左侧搜
"ctrl+d",确认它本该调用find_under_expand - 在右侧 User 和所有插件目录(
Packages/Vintage/、Packages/Emmet/等)里全局搜索"keys": ["ctrl+d"]—— Vintage 插件就常在这里偷偷把Cmd+D改成 vi 模式下的操作 -
User.sublime-keymap是纯 JSON 数组,语法错一点整份就静默失效:必须用英文双引号、数组末尾不能多逗号、不支持//注释
怎么安全地重映射常用快捷键?
别删原绑定,加新绑定更稳妥,尤其跨平台时注意键名语义:
- 想改命令面板快捷键?在 User 文件里加:
[{"keys": ["ctrl+alt+p"], "command": "show_overlay", "args": {"overlay": "command_palette"}}] - macOS 上别写
"ctrl+shift+f",要用"super+shift+f"——super在 macOS 对应 Cmd,在 Windows/Linux 对应 Ctrl,这才是真正跨平台写法 - 禁用某条绑定?别删,改成
"command": "not_a_real_command",避免 JSON 格式意外破坏 - 高频操作如保存、撤销,避开
Ctrl+Shift+字母类组合(易被输入法拦截),可考虑["ctrl+k", "s"]这种 chord 形式
Esc、Tab、Cmd+B 这些键为啥死活改不了?
它们不走任何 .sublime-keymap 流程,是 Sublime 内核硬编码行为。
-
Esc关命令面板、搜索框、替换栏,无论你在 Default 还是 User 里写{"keys": ["escape"], "command": "hide_panel"}都无效,还可能让面板卡住 -
Tab在普通编辑区插入缩进,在命令面板里切换选项,在自动补全中选候选词——行为由上下文(context)决定,不是靠 keymap 绑定 - 这类键出了问题,优先跑
subl --safe-mode验证是否插件劫持(Vintage、Origami 常干这事),而不是修 keymap
真正难处理的从来不是怎么写 JSON,而是搞清哪一层在起作用——系统层截断、插件层覆盖、内核层硬编码,三者混在一起,日志才是唯一可信的线索。


















