答案:通过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 不报错也不提示。最稳方法是实测:
- 按
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"} - 别信旧教程里的
js_format或beautify——插件一升级,命令名可能全换;format_code这类名多来自插件,得查你装的 Prettier / Black / ESLint 插件文档
怎么安全覆盖 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
args 怎么传、context 怎么写才不白配
很多命令必须带 args 才能跑起来,比如打开命令面板、跳转函数列表、运行宏。args 必须是字典,嵌套在命令对象里,不能平级写:
{"keys": ["ctrl+p"], "command": "show_overlay", "args": {"overlay": "goto", "text": "@"}}
路径类参数要用 res:// 协议,比如调用内置删除行宏:"args": {"file": "res://Packages/Default/Delete Line.sublime-macro"}。
context 控制触发条件,漏写可能在不该触发的地方乱响(比如在命令面板里按 Ctrl+Shift+P 时意外触发补全)。常见 key 有:selection_empty、preceding_text、auto_complete_visible。正则判断要用 "operator": "not_regex_contains",比如屏蔽注释行:{"key": "preceding_text", "operator": "not_regex_contains", "operand": "^\s*//|^\s*#"}。
真正容易被忽略的,是 context 的“且”逻辑和 args 的嵌套层级——少一层大括号,或者把 args 写到外层,命令就完全不认。











