Key Promoter X 默认常被“静音”，需手动启用：勾选Enable Key Promoter X、将Minimum number of clicks设为1、勾选Context menu actions，否则不提示不弹窗不统计。
Key Promoter X 在 PhpStorm 中能起作用，但默认设置下大概率不提示、不弹窗、不统计 —— 不是插件坏了，而是它被“静音”了。
安装后没反应？先检查这三项启用状态
装完重启 PhpStorm，右下角没气泡、侧边没统计栏，90% 是以下三个开关没打开：
-
Enable Key Promoter X必须勾选（Settings > Tools > Key Promoter X） -
Minimum number of clicks before showing notification默认是 3，新手建议直接改成1—— 点一次就提醒，否则你可能永远等不到第一次提示 -
Context menu actions默认不监听右键菜单，但实际开发中大量操作（比如“Refactor > Extract Method”）都从右键触发，务必手动勾选
为什么点了“Find in Path”却提示 Ctrl+Shift+F，但按了没反应？
Key Promoter X 只读取当前快捷键绑定，不验证是否真能执行。常见失效原因：
- 系统级拦截：macOS 上
Cmd+Shift+F默认被 Finder 占用，需进「系统设置 > 键盘 > 快捷键 > Spotlight」关掉 - IDE 内焦点错位：在 Terminal 面板里按
Ctrl+Shift+F，输入直接发给 shell；得先按Esc退出终端聚焦，再试 - 快捷键被禁用或冲突：进 Settings > Keymap，搜索
Find in Path，看右边是否显示灰色或带黄色感叹号图标
哪些操作它根本不会提示？别白等
Key Promoter X 只监控 IDE UI 层的显式动作，不追踪代码编辑行为或隐式触发逻辑：
立即学习“PHP免费学习笔记（深入）”；
- 它不监听键盘输入本身（比如敲
if自动补全if (...) { }） - 不覆盖 Editor Actions（如
Ctrl+W扩展选区、Ctrl+Alt+L格式化），除非你用鼠标点菜单里的对应项 - 不提示未绑定快捷键的功能 —— 如果你在 Keymap 里搜不到某个功能的快捷键，那 Key Promoter X 就不会弹窗
和其它插件共存时容易踩的坑
尤其注意两个高频冲突点：
-
Key Promoter X自身的Auto-assign new shortcuts如果开启，可能把新快捷键绑到已有功能上，导致原快捷键失效 -
ideavim插件会接管几乎所有按键，包括Ctrl+/注释 —— 此时 Key Promoter X 提示的快捷键仍显示，但实际按下去没反应，得临时禁用 ideavim 验证 - 某些主题插件（如 Darcula 增强版）会覆盖通知样式，导致气泡弹窗透明或位置偏移，可尝试切换回默认主题排查
真正卡住人的往往不是插件装不上，而是它“看起来在运行”，实则一半功能被默认阈值、上下文限制或外部插件悄悄屏蔽了 —— 每次怀疑失效，优先查 Settings > Tools > Key Promoter X 页面里的三个勾选项和数字 1。
