key promoter x 插件需重启 idea 才生效，且默认仅在连续 3 次鼠标操作后提示，须手动将阈值设为 1 并启用菜单/工具栏提示，同时确认插件已启用并匹配 idea 版本。
Key Promoter X 插件装上就能用，但不重启 IDEA、不检查启用状态、不调低默认提示阈值，它大概率不会弹出任何提示——不是插件坏了，是它被“静音”了。
安装后必须重启 IDEA 才生效
插件市场下载安装完成后，IDEA 不会自动热加载 Key Promoter X。很多用户卡在“装完了怎么没反应”，其实就差这一步：
- 关闭所有 IDEA 窗口（包括后台进程，macOS 注意 Dock 图标右键「退出」）
- 重新启动 IDEA
- 启动后可立即测试：点击菜单栏
File → New → Project…，右下角应弹出提示框，显示对应快捷键Ctrl+Shift+N（Windows/Linux）或Cmd+Shift+N（macOS）
插件默认不提示单次鼠标操作
Key Promoter X 默认只在你「连续 3 次以上」用鼠标触发同一操作时才弹窗提醒。这意味着第一次点「Refactor → Rename」，它不会跳出来——你得手动改设置：
- 进入
Settings → Tools → Key Promoter X - 把
Minimum number of mouse clicks before showing a hint改成1 - 勾选
Show hints for toolbar buttons和Show hints for menu items（默认可能未全开） - 改完不用重启，设置实时生效
提示不出现？先确认插件是否真正启用
即使插件显示为「Installed」，也可能处于禁用状态。常见于更新 IDEA 后插件被自动禁用，或离线安装时签名校验失败：
- 打开
Settings → Plugins - 在已安装列表中找到
Key Promoter X - 检查右侧开关是否为 ON（不是灰色，而是蓝色/绿色）
- 如果开关是灰色且不可点，说明插件与当前 IDEA 版本不兼容——去
https://plugins.jetbrains.com/plugin/9792-key-promoter-x下载匹配你 IDEA 版本的最新 release（例如 2024.2.x 对应 IDEA 2024.2）
统计面板打不开？侧边工具窗口名是 Key Promoter X
很多人搜 KeyPromoter 或 Key Promoter 找不到面板，因为它的正式窗口名带空格和大写 X：
- 按
Alt+8（Windows/Linux）或Cmd+8（macOS）呼出工具窗口栏 - 滚动查找名为
Key Promoter X的条目（注意末尾的X） - 首次打开时，它会显示「Missed shortcuts」计数，比如
Find in Path: 7表示你用鼠标点「Find in Path」7 次，而它本可用Ctrl+Shift+F替代 - 这个面板不自动常驻，关掉后需手动再开；建议右键标题栏 →
Pin Tab固定
最容易被忽略的是阈值设为 1 之后，大量提示会密集弹出——尤其在刚切换工作流时。别急着关掉，前两天忍一忍，等高频操作（如重命名、格式化、运行）的快捷键肌肉记忆形成，后续提示频率自然下降。它不是教你怎么用 IDEA，而是帮你发现自己已经在用什么，只是没意识到还能更快。
