Key Promoter X 仅在鼠标点击时提示对应快捷键，不悬停提示、不主动教学；需检查是否启用编辑器操作监控、按钮是否启用、IDE缓存是否异常；统计不精准，仅作习惯改进参考。
Key Promoter X 不是“教你怎么按快捷键”的教程插件，而是当你用鼠标点按钮时，它才弹出对应快捷键——不点不提示，不学不生效。
安装后没反应？检查这三件事
插件装完重启 IDE，但右下角始终没提示，大概率卡在这几个地方：
- 默认只监控「工具栏按钮」「菜单项」「工具窗口开关」，比如你点
File → Settings会提示Ctrl+Alt+S，但点编辑器里的「格式化代码」图标（Ctrl+Alt+L）可能不触发——因为该图标属于编辑器上下文操作，需在Settings > Tools > Key Promoter X中勾选Enable for editor actions - 鼠标点击的是灰色禁用状态按钮（如未选中文件时的
VCS → Git → Commit），插件直接跳过，不会提示 - IDE 缓存异常或索引未完成：执行
File → Invalidate Caches and Restart → Invalidate and Restart，尤其在刚导入大项目后
为什么点了设置菜单没弹快捷键？
常见现象：鼠标悬停在 Settings 菜单项上无提示，但点击后右下角才闪一下。这是因为 Key Promoter X 默认只对「点击动作」响应，不监听悬停——它不猜你打算做什么，只记录你实际做了什么。
想让它更敏感，进 Settings > Tools > Key Promoter X 调整以下两项：
立即学习“PHP免费学习笔记（深入）”；
-
Show notification on mouse click：保持开启（默认） -
Delay before showing notification (ms)：从默认 300 改成 100，减少“点了才想起来看提示”的滞后感 - 别开
Count only shortcuts that are not used yet——否则你已熟记的Ctrl+B点了也不会提示，失去训练意义
统计面板里“Clicks”数字不准？别信它
侧边栏显示的点击次数（Clicks）只是粗略计数，不区分功能类型，也不去重：
- 连续两次点同一个「Run」按钮，算 2 次，哪怕你其实只想启动一次服务
- 点菜单里的子项（如
Refactor → Rename）和点工具栏同功能图标，被算作不同动作，但快捷键都是Shift+F6 - 它不记录你是否真按了提示的快捷键——哪怕你看到提示后还是继续用鼠标，数字照涨
这个统计唯一有用的地方：当某类操作（比如频繁点「Terminal」标签）点击数飙升，说明你该主动去查它的快捷键 Alt+F12 并强制自己改习惯。
真正容易被忽略的细节
Key Promoter X 的提示文案里常带括号标注作用域，比如：Ctrl+Shift+N (Find File) vs Ctrl+Shift+N (Go to File)。看似一样，实则前者是旧版描述，后者才是当前 PhpStorm 2026.x 的准确语义——它不校验快捷键是否真能执行，只按 IDE 内部 action ID 绑定文案。所以别光看提示按下去，先确认你当前焦点在编辑器（而非终端或调试控制台），否则 Ctrl+Shift+N 可能被拦截或无响应。
