必须通过Preferences → Key Bindings打开右侧User.sublime-keymap文件编辑,保持合法JSON数组格式(如[{"keys":["ctrl+alt+d"],"command":"duplicate_line"}]),command名须用Ctrl+Shift+P或控制台log_commands实测获取,保存即生效。

直接改 User.sublime-keymap 文件,不是点菜单配,也不是装插件;写错 command 或 JSON 格式不合法,快捷键就静默失效,不报错也不提醒。
怎么打开并编辑正确的 User.sublime-keymap 文件
点菜单 Preferences → Key Bindings,会并排打开两个文件:左侧是只读的默认配置(如 Default (Windows).sublime-keymap),右侧才是你要编辑的 User.sublime-keymap。所有自定义都必须写在这里,改别的路径或文件完全无效。
- 首次打开时右侧常为空,但必须保持合法 JSON 数组格式——哪怕只加一条规则,也得用方括号
[ ]包裹 - 示例正确写法:
[{"keys": ["ctrl+alt+d"], "command": "duplicate_line"}] - 保存后立即生效,不用重启、不用 reload
- 右下角弹红字?90% 是 JSON 错误:末尾多逗号、引号没闭合、用了中文标点、括号不匹配
怎么拿到准确的 command 名,而不是抄网上过时教程
command 名写错,快捷键就等于没配。网上搜到的 delete_line、js_format 等旧名在当前版本(2026 年)基本已失效。Sublime 不会提示错误,只会让你按了没反应。
- 最稳方法:按
Ctrl+Shift+P打开命令面板,输入功能关键词(如 “delete line”),看到的完整条目名就是真实command值(例如run_macro_file) - 更准验证:按
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.file路径,漏掉args或路径写错,快捷键照样不响应
为什么加了快捷键却没反应?三个高频卡点
常见失效原因就三个,不是插件冲突,也不是系统拦截:
-
JSON格式错误:保存后右下角有红字提示,但很多人忽略它 - 被更高优先级规则拦截:Sublime 从左到右加载键绑定,左侧默认文件里已有
"keys": ["f5"]绑定到build,你在右侧也写"keys": ["f5"]却没加context,那你的规则会被默认规则覆盖 -
context限制太严:比如写了{"key": "selector", "operand": "source.python"},但你在 Markdown 文件里按快捷键,自然不触发——查当前语法按Ctrl+Shift+P → Show Scope Name看实际 scope 值
安全覆盖 Ctrl+D、Ctrl+S 这类高频键
直接把 Ctrl+D 改成 duplicate_line,你就再也无法连续选中相同文本了;把 Ctrl+S 改成别的,保存动作就卡住。这不是增强,是置换。
- 想保留原功能又新增行为,必须加
context限定:只在无选区时触发复制行:"context": [{"key": "selection_empty", "operator": "equal", "operand": true}] - 只在 Python 文件中生效:
"context": [{"key": "selector", "operator": "equal", "operand": "source.python"}] - 多个
context条件是“且”关系;想实现“或”,必须拆成两条独立规则 - 禁用某个默认键,别留空或写
null,要显式写"command": "unbound"
真正容易被忽略的是:Sublime 的快捷键逻辑依赖 scope、selection 状态、甚至当前是否在查找面板里——同一个 keys 组合,在不同上下文可能触发完全不同行为。别只盯着 command 名,先看清楚你按下的那一刻,编辑器到底“认为”你在做什么。


















