key promoter x 默认不提示、不统计，必须手动启用插件并完全重启idea；启用后需检查设置中“enable key promoter x”开启、触发范围匹配且通知行为已优化，离线安装须确保版本兼容。
Key Promoter X 能用，但默认不提示、不统计——必须手动启用并重启，否则你点一百次鼠标它也不会弹窗。
安装后没反应？先确认插件是否真正启用
很多人装完就以为万事大吉，结果点击菜单或工具栏毫无提示。根本原因是插件虽已下载，但处于“禁用”状态。
- 进
File → Settings → Plugins，在右侧列表里找到Key Promoter X - 检查复选框是否勾选——未勾选=没启用，即使显示“Installed”也无效
- 勾选后必须点击右下角
Apply，再点OK，最后**完全退出 IDEA 并重新启动**（仅 “Reload project” 不够） - 重启后，右下角状态栏会出现
KP-X图标，表示已运行
点了按钮还是没提示？检查触发范围和设置项
Key Promoter X 不是全功能覆盖，它只对明确映射了快捷键的 UI 操作起作用，比如菜单项、工具栏按钮、主窗口右键菜单等。编辑器内双击变量名、拖动滚动条这类操作不会触发。
- 进
Settings → Tools → Key Promoter X，确保Enable Key Promoter X打开 - 关闭
Ignore actions triggered by keyboard（否则按快捷键时也会被统计，干扰判断） -
Show notification on every missed shortcut建议开启；若嫌频繁，可调高Minimum number of misses before showing notification（默认是 1） - 某些操作（如右键菜单里的 “Find Usages”）需鼠标**右键后悬停再点击**才触发提示，快速点击可能漏捕获
提示弹窗一闪而过？调整通知行为更实用
默认通知是右下角 Toast 弹窗，3 秒自动消失，容易错过。尤其当你正专注写代码时，根本来不及看清快捷键是什么。
- 在
Settings → Tools → Key Promoter X中，勾选Keep notification visible until clicked - 同时开启
Show statistics in tool window，这样侧边栏会固定出现Key Promoter X工具窗口，实时显示各操作被“错失”的次数 - 高频操作如
Rename（Shift+F6）、Extract Method（Ctrl+Alt+M）通常几小时内就会出现在统计顶部，优先记这几个
离线安装失败？版本兼容性是最大雷区
从 JetBrains Marketplace 下载的 ZIP 包自带版本号（如 Key_Promoter_X-2024.2.2.zip），它只兼容对应年份/季度的 IDEA 版本。用旧版插件装新版 IDEA，大概率提示 “Incompatible” 并静默失败。
- 先查自己 IDEA 版本：
Help → About，看 Build 号末尾（如242.23728.19对应 2024.2） - 去插件官网 https://www.php.cn/link/261408893f0adaea4af2b80df4303b4a 找匹配版本下载
- 离线安装路径：
Settings → Plugins → ⚙️ → Install Plugin from Disk…，选中 ZIP 文件，**不要解压** - 如果仍报错，说明 IDE 内核版本太新，插件尚未适配——此时只能等作者更新，或降级插件（不推荐）或暂缓使用
最常被忽略的一点：它不记录你“已经会用”的快捷键，只提醒你“本可以用却没用”的操作。所以前两周你会频繁看到弹窗，之后统计窗口里逐渐只剩几个顽固项——那才是真正卡住你效率的盲点。
