通过preferences → key bindings打开,右侧即user.sublime-keymap文件,必须以合法json数组格式编辑,如[{"keys":["ctrl+alt+s"],"command":"save"}],保存后立即生效;command名须经ctrl+shift+p或sublime.log_commands(true)实测获取。

怎么打开并编辑正确的 User.sublime-keymap 文件
所有自定义快捷键必须写在 User.sublime-keymap 里,改其他文件无效,升级后还会丢。点菜单 Preferences → Key Bindings,左侧是只读的默认配置(比如 Default (Windows).sublime-keymap),右侧才是你要编辑的 User.sublime-keymap。
首次打开时右侧常为空,但必须保持合法 JSON 数组格式——哪怕只加一条规则,也得用方括号 [ ] 包裹,例如:
[{"keys": ["ctrl+alt+s"], "command": "save"}]
保存后立即生效,不用重启、不用 reload。右下角弹红字?90% 是 JSON 格式错:末尾多逗号、引号没闭合、混用了中文标点。
怎么找对 command 名,而不是靠猜
command 写错,快捷键就静默失效,Sublime 不报错也不提示。网上搜到的旧教程常写 js_format 或 beautify,但这些早被插件更新淘汰了。
- 最稳方法:按
Ctrl+Shift+P打开命令面板,输入功能关键词(如 “delete line”),看到的完整条目就是真实command值,例如run_macro_file而不是delete_line - 备用方法:按
Ctrl+`打开控制台,输入sublime.log_commands(True),再手动点一次菜单里的目标操作(比如 Edit → Line → Delete Line),控制台会打出类似:command: run_macro_file {"file": "res://Packages/Default/Delete Line.sublime-macro"} - 像“删除整行”这种功能,原生不叫
delete_line,而是run_macro_file加args;直接写错名就完全不触发
怎么安全覆盖 Ctrl+D、Ctrl+S 这类高频键
直接覆盖 Ctrl+D(默认“选择相同词”)为 duplicate_line,原功能就彻底没了。这不是“改得更顺”,而是“删掉一个常用功能换另一个”。
- 真要共存,得加
context:让Ctrl+D只在无选区时复制行:"context": [{"key": "selection_empty", "operator": "equal", "operand": true}] - 多个
context条件是“且”关系;想实现“或”,必须拆成两条独立规则 - 想禁用某个默认键,别留空或写
null,要显式写"command": "unbound" - 修饰键顺序有影响:
["ctrl+shift+f"]和["shift+ctrl+f"]多数情况一样,但 Sublime 内部按顺序匹配,建议按惯例写ctrl+alt+shift+super
怎么绑定带 context 的快捷键(比如只在 Python 文件中生效)
很多快捷键需要限定作用域,否则可能在命令面板、侧边栏里误触发。这时得加 context 字段:
-
"key": "selector"最常用,值是作用域字符串,比如"source.python"表示只在 Python 文件中生效 -
"key": "setting"可检查编辑器状态,如"auto_complete_visible"判断补全框是否弹出 -
"operator": "equal"和"operand": true必须组合使用,不能漏掉operand - 鼠标快捷键需另建
Default (Windows).sublime-mousemap或User.sublime-mousemap文件,不在User.sublime-keymap里生效
JSON 格式错误和 context 条件写错是两个最常被忽略的点:前者导致整个文件静默失效,后者让快捷键看似生效却总不触发——尤其当作用域字符串拼错或大小写不对时,Sublime 完全不报错。











