必须通过ctrl+shift+p搜索插件功能关键词，或启用sublime.log_commands(true)后触发功能查看控制台输出，才能确认command名是否真实可用；仅凭文档或猜测命名会静默失败。
怎么确认插件命令名是否可用
插件安装后不会自动注册快捷键，必须手动绑定；但前提是插件确实暴露了可调用的 command。很多插件（比如 SideBarEnhancements 或 BracketHighlighter）只提供菜单项或右键菜单，不自带命令接口。直接写 "command": "some_plugin_do_something" 很可能静默失败。
验证方法只有两个：
- 按
Ctrl+Shift+P输入插件功能关键词（如 “file browser”、“jump to matching bracket”），看命令面板里是否出现对应条目——出现的完整名称才是真实command值 - 若插件文档明确写了命令名（如
sublime_linter_toggle），仍建议在控制台执行sublime.log_commands(True)后手动触发一次该功能，确认输出的command:行是否一致
如何避免快捷键被默认规则覆盖
插件命令常和 Sublime 原生命令共存（比如 side_bar_files_open_with 和原生的 open_file），若你写的 keys 和默认绑定冲突（如都用了 ["ctrl+alt+o"]），Sublime 会优先执行左侧 Default 文件里的规则，你的用户配置不生效。
解决方式不是删默认配置，而是显式“抢占”：
- 确保你的规则写在
User.sublime-keymap（右侧文件），且格式为合法 JSON 数组：开头是[，结尾是] - 加
"context"锁定作用域，例如只在侧边栏聚焦时生效：{"key": "panel_has_focus", "operator": "equal", "operand": "side_bar"} - 如果插件命令本身依赖文件类型（如只对 Python 文件生效），补上
{"key": "selector", "operator": "equal", "operand": "source.python"}
带参数的插件命令怎么写才有效
不少插件命令必须带 args 才能运行，漏掉或写错字段会导致按键无反应。典型例子是 PackageResourceViewer: Open Resource 插件，它的命令是 open_resource，但必须传 {"type": "package"}，否则打开的是空对话框。
常见参数陷阱：
-
args是对象，不是字符串，不能写成"args": "{...}" - 路径类参数（如
file）要用res://协议，例如"res://Packages/SomePlugin/some.sublime-macro" - 布尔值写
true/false，别写"true"字符串 - 示例（为
Expand Selection to Quotes插件绑定）：[{"keys": ["ctrl+shift+'"], "command": "expand_selection_to_quotes", "args": {"quote": "'"}}
为什么插件快捷键在某些视图里不触发
Sublime 的快捷键有视图上下文限制。比如你在编辑器里按 Ctrl+Shift+P 调出命令面板，此时焦点在面板上，即使你绑定了 some_plugin_command，它也不会响应——因为默认 context 不匹配。
查当前焦点状态的方法：
- 按
Ctrl+Shift+P→ 输入show_scope_name，看状态栏显示的 scope（如text.command_palette） - 在控制台执行
sublime.active_window().active_view().scope_name(0)获取当前光标位置的完整 scope 字符串 - 常用 context key：
panel_has_focus（面板）、is_popup_visible（弹窗）、selection_empty（无选区）、setting.is_widget（是否是设置页）
插件功能往往只在特定上下文有意义，硬塞进所有场景反而容易失效。最稳妥的做法是：先搞清插件设计意图，再按实际使用场景写 context，而不是盲目加全局绑定。
