冲突时是后加载的键位文件覆盖前者的绑定，优先级为default.sublime-keymap→default (os).sublime-keymap→平台专属文件；排查需检查用户键位、平台默认键位及context上下文限制。
快捷键冲突时，sublime-keymap 文件里哪一行在“抢”你的绑定？
Sublime Text 的快捷键优先级由加载顺序决定：用户自定义的 Preferences.sublime-settings 不影响快捷键，真正起作用的是 Default (OS).sublime-keymap 和 Default.sublime-keymap（平台无关 fallback），最后才是 Default (Windows).sublime-keymap、Default (Linux).sublime-keymap、Default (OSX).sublime-keymap。冲突往往不是“重复定义”，而是后加载的文件覆盖了前者的绑定。
排查步骤：
- 打开
Preferences → Package Settings → Key Bindings，左侧是默认键位（只读），右侧是用户键位（可编辑） - 若你绑定了
ctrl+shift+p却没反应，先查右侧是否写了它；再查左侧对应平台文件中是否有相同组合被command或application上下文限制（比如只在命令面板打开时生效） - 用
Ctrl+Shift+P输入Set Syntax: Plain Text临时切到无插件干扰环境，再测试快捷键——排除插件劫持 - 关键线索看
"context"字段：同一按键在不同上下文（如"key": "setting.is_widget"）可能绑定不同行为，表面没冲突，实则“条件性失效”
Windows/Linux/macOS 三端统一写法，为什么不能直接复制粘贴？
macOS 的 super 对应 Windows/Linux 的 ctrl，但反过来不成立：Windows 用户按 ctrl+shift+f，macOS 用户按 cmd+shift+f 才等效。Sublime Text 内部用 super 表示 macOS 的 Command 键、Windows/Linux 的 Ctrl 键——这是唯一跨平台语义键名。
错误写法示例（会导致 macOS 失效）：
[
{ "keys": ["ctrl+shift+f"], "command": "show_panel", "args": {"panel": "find"} }
]
正确写法（三端自动映射）：
[
{ "keys": ["super+shift+f"], "command": "show_panel", "args": {"panel": "find"} }
]
注意：
-
alt在 macOS 上对应 Option 键，在 Windows/Linux 上对应 Alt 键，语义一致，可直接用 -
ctrl在 macOS 上是 Control 键（极少用于主操作），不要用它替代super - 如果必须区分平台（比如调用系统命令行），可用
"platform": "windows"等字段做条件分支，但会增加维护成本
插件快捷键和用户键位打架，怎么快速定位是哪个插件干的？
插件通常把键位写在自己的 Default.sublime-keymap 里，且加载顺序在用户键位之后，因此能覆盖你的设置。最直接的办法是禁用插件逐个排查：
- 打开
Preferences → Package Control → Disable Package，选一个插件禁用后重启 Sublime Text - 用
Ctrl+Shift+P运行Key Map Manager: Show Active Key Bindings（需提前安装该插件），它会列出当前所有生效的快捷键及其来源路径 - 更轻量的方法：在用户键位文件里加一条带明显副作用的测试绑定，比如
{"keys": ["f12"], "command": "echo", "args": {"message": "test hit!"}}，确认你的修改能生效，再逐步删减插件 - 常见“抢键大户”：
Emacs Pro Essentials、SideBarEnhancements、GitGutter—— 它们的默认super+shift+k、ctrl+alt+shift+p等容易撞车
改完 Default.sublime-keymap 没生效，是不是缓存没刷新？
Sublime Text 不缓存键位文件，修改保存后立即生效——除非你改错了位置或格式。常见失效原因：
- 文件名拼错：
Default.sublime-keymap必须全小写，不能是default.sublime-keymap或Default (User).sublime-keymap（后者是合法但属于用户区，和插件区不冲突） - JSON 格式错误：多一个逗号、少一个引号、用中文标点，Sublime Text 会静默忽略整个文件，不报错也不提示
- 用了 Windows 路径反斜杠
当作 JSON 字符串转义，实际应统一用正斜杠/或双反斜杠\ - 键位数组里混入空格或换行导致解析失败，例如
["super + shift + f"]（带空格）是非法的，必须写成["super+shift+f"]
真正难察觉的点是：同一个快捷键在多个上下文（context）中被多次定义，而你只改了其中一个——得通读整个数组，确认没有遗漏的分支条件。
