keymaps插件需手动调用命令启动，不自动弹窗；若命令未出现则插件未加载成功，常见原因包括安装失败、依赖缺失或被禁用；其显示的“冲突”实为多源叠加，灰色条目表示context不匹配，并非错误。
Keymaps 插件装完没反应？先确认它真在运行
装了 Keymaps 插件却打不开快捷键总览，大概率是没正确触发命令。它不自动弹窗，也不加菜单项，全靠命令面板调用。
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Keymaps: Show All Key Bindings 并回车——这是唯一启动方式。如果命令没出现在列表里，说明插件根本没加载成功。
常见原因包括：
-
Package Control安装中途失败，检查控制台是否有ImportError或no module named keymaps - 插件依赖的 Python 模块缺失（如
jinja2），尤其在 Sublime Text 4 的某些精简版环境中 - 插件被手动禁用：执行
Package Control: Enable Package，再搜Keymaps
Keymaps 显示的“冲突”其实是叠加结果，不是报错
Keymaps 会把所有来源的绑定全列出来：Default、插件自带的 Default.sublime-keymap、User.sublime-keymap，甚至 Packages/User/xxx.sublime-keymap。它把相同 keys 的条目并排显示，但不会标红说“冲突”，因为 Sublime 本就不禁止重复绑定——后加载的才生效。
真正要盯的是右侧“Source”列：
- 如果某快捷键（如
ctrl+shift+p）在Vintage插件的Default.sublime-keymap里出现，且 context 是{"key": "setting.command_mode", "operator": "equal", "operand": true}，那它只在 Vim 命令模式下起作用，普通编辑时压根不匹配 - 如果同一组合在
User.sublime-keymap和某个插件的Default里都存在，而User文件里那条command是空的或拼错了（比如"command": "toggle_coment"），它就会静默吞掉按键，不报错也不执行
别信 Keymaps 的“全部列出”，有些绑定它根本看不到
Keymaps 只扫描磁盘上存在的 .sublime-keymap 文件，但它漏掉三类真实生效的绑定：
- 通过插件 Python 代码动态注册的快捷键（比如某些 Git 插件在初始化时用
view.run_command()绑定临时热键） - 带复杂 context 表达式、且当前视图不满足条件的绑定（例如只在
source.python语法下生效的ctrl+enter，你在 Markdown 文件里查不到） - 被系统级程序劫持的快捷键（如搜狗输入法的
ctrl+shift+p），Sublime 根本收不到事件，Keymaps当然无从显示
这时候必须切回控制台，用 sublime.log_input(True) 看按键进没进来，再用 sublime.log_commands(True) 看最终执行了啥——这才是唯一能穿透所有层级的验证方式。
导出 HTML 后发现一堆灰色条目？那是 context 不匹配的“幽灵绑定”
Keymaps 导出的 HTML 中，灰色行表示该绑定当前上下文不满足，不会触发。这不是 bug，是 Sublime 的设计逻辑。但容易误导人以为“这键没被占”，其实它只是暂时休眠。
比如你看到 ctrl+/ 在 Emmet 插件里被定义为 emmet_expand_abbreviation，但整行是灰色的，说明你当前文件类型不在 Emmet 支持范围内（比如是 .txt）。可一旦你把文件保存为 .html，它立刻变黑生效，原生的 toggle_comment 就被覆盖了。
排查这类问题的关键动作是：
- 在目标文件类型中打开一个真实文件（别用未命名的 Untitled）
- 用
Ctrl+Shift+P→View Package File→ 搜插件名，直接打开它的Default.sublime-keymap，看 context 条件怎么写的 - 在控制台运行
view.settings().get("syntax")，确认当前语法标识符是否匹配绑定里的source.xxx
真正的冲突往往藏在 context 的真假之间，而不是 JSON 文件里明面上的重复。
