User.sublime-keymap必须用合法JSON数组格式编辑，自定义键绑定须写在右侧用户文件中，command名需实测获取，context用于限定作用域，覆盖默认快捷键需谨慎。
User.sublime-keymap 文件必须写对，否则快捷键完全不生效——不是报错，而是静默失败，连提示都没有。
怎么打开并编辑正确的配置文件
点菜单 Preferences → Key Bindings，会并排打开两个文件：左侧是只读的 Default (Windows).sublime-keymap（或对应系统名），右侧才是你要编辑的 User.sublime-keymap。所有自定义都必须写在这里，改其他地方无效，升级还可能直接覆盖。
首次打开时右侧常为空，但必须是合法 JSON 数组格式——哪怕只加一条规则，也得用方括号 [ ] 包裹：
[{"keys": ["ctrl+alt+p"], "command": "prompt_select_workspace"}]
常见错误包括：漏掉外层方括号、逗号多写或少写、混用中文引号、最后一项后多加逗号。右下角弹红字？90% 是 JSON 语法错。
command 名必须实测获取，不能靠猜或搜旧教程
Sublime 的 command 名随版本和插件变化很快。比如“删除整行”在新版里不是 delete_line，而是通过 run_macro_file 调用内置 macro；js_format 已基本被 eslint_fix 或 black 替代。
准确获取方式有两种：
- 按
Ctrl+Shift+P打开命令面板，输入功能关键词（如“delete line”），看到的完整条目名就是真实command值 - 按
Ctrl+`打开控制台，输入sublime.log_commands(True)，再手动执行一次目标操作（比如菜单里点“删除行”），控制台会输出类似：command: run_macro_file {"file": "res://Packages/Default/Delete Line.sublime-macro"}
别跳过这步。填错 command = 快捷键完全不响应，且无任何提示。
作用域绑定（context）决定快捷键在哪生效
快捷键默认全局生效，但多数场景需要限定：比如只想在 Python 文件里按 Ctrl+Enter 插入 print()，而不是在 Markdown 里也触发。
做法是加 context 字段，最常用的是匹配作用域：
- 打开一个
.py文件，按Ctrl+Shift+P输入show_scope_name回车，状态栏显示类似source.python——这就是你要用的 scope - 写规则时，
context是一个数组，每个对象表示一个条件，多个条件是“且”关系 - 示例：仅在 Python 文件中触发的
print()快捷键
[{
"keys": ["ctrl+enter"],
"command": "insert_snippet",
"args": {"contents": "print($1)$0"},
"context": [
{"key": "selector", "operator": "equal", "operand": "source.python"}
]
}]
注意：context 必须和 keys、command 同级，不能嵌套错位置；operand 值要严格匹配作用域字符串，大小写敏感。
覆盖高频键（如 Ctrl+S、Ctrl+D）前必须想清楚后果
硬覆盖 Ctrl+S（保存）或 Ctrl+D（选词）会导致原有功能消失，不是“更顺手”，而是“更卡顿”。
稳妥做法有三种：
- 换组合键：比如用
Ctrl+Alt+S代替Ctrl+S，但注意某些 Windows 输入法会吞掉Ctrl+Alt - 加 context 限定：让
Ctrl+D只在无选区时复制当前行，需同时判断selection_empty和作用域 - 显式禁用原键：如果真要废掉某个默认行为，得写
"command": "unbound"，不能留空或删整条
context 多条件是“且”关系；想实现“或”，得拆成两条独立规则。参数、字段位置、嵌套结构稍有偏差，整个规则就失效——它不报错，只是安静地不工作。
