MyBatisX插件不生效的主因是未满足两个硬性前提：项目必须为Maven/Gradle标准结构，且Mapper接口与XML文件需严格遵循命名规范（接口全限定名=XML中namespace，方法名=id值），否则跳转、图标均不可用。
MyBatisX 插件装不上、装了不生效、点了没反应——不是你项目有问题，大概率是没满足它的两个硬性前提：Maven/Gradle 项目结构 + 标准命名规范。只要这两点对了，跳转就是开箱即用，不用手动配引用。
MyBatisX 安装后不显示小鸟图标？先检查项目结构
插件只识别标准构建工具管理的项目：Maven 或 Gradle。如果你用的是纯 Java Module（File → New → Module → Java），或者老式 Ant 项目，MyBatisX 根本不会激活图标和跳转逻辑。
- 确认
pom.xml或build.gradle存在且被 IDEA 正确识别（右下角有 Maven/Gradle 工具栏） - Mapper 接口必须放在
src/main/java下，XML 必须放在src/main/resources（或配置过的resources路径） - 如果 XML 放在
src/main/java同级目录但非 resources，需在pom.xml中显式声明资源路径，否则 IDEA 不会扫描
Mapper 方法点击无跳转？核对命名与 namespace
MyBatisX 依赖接口全限定名与 XML 的 namespace 完全一致。它不靠文件名匹配，靠的是 namespace 值。
- 接口类：如
com.example.mapper.UserMapper - 对应 XML 的
namespace必须是：<mapper namespace="com.example.mapper.UserMapper"> - 方法名必须与 XML 中
<select id="listUsers">的id完全一致（大小写敏感） - 如果用了
@Mapper注解但没配namespace，XML 里又没写namespace，跳转直接失效
Ctrl+Click 跳不到 XML？快捷键和光标位置有讲究
不是所有地方都能触发跳转。官方支持的入口只有两个：
- 在 Mapper 接口里，把光标停在方法名上（比如
selectById），按Ctrl + Click（Windows/Linux）或Cmd + Click（macOS） - 在 XML 里，把光标停在
id属性值上（比如id="selectById"的selectById字符串），再Ctrl + Click - 别点标签名（如
<select>）、别点 SQL 内容、别点注释——这些位置不响应跳转 - 如果用了
@Select注解，MyBatisX默认不处理，只认 XML 映射
装了插件但图标不出现？重启和缓存是关键
安装后必须重启 IDEA，且首次加载可能因索引未完成而延迟显示图标（尤其大项目）。等几秒，或手动触发索引重建。
- 安装完点击
Restart IDE，不要只点Apply - 如果重启后仍无图标，尝试
File → Invalidate Caches and Restart → Invalidate and Restart - 检查是否误开了
Power Save Mode（状态栏右下角有图标），该模式下插件功能会被禁用 -
MyBatisX不兼容某些旧版 IDEA（如2021.1以下），建议使用2023.3+或2024.x
真正卡住人的从来不是安装步骤，而是 namespace 拼错一个字母、XML 路径没被 Maven 当作资源目录打包、或者光标点在了不该点的位置——这些细节不校验，装十遍插件也没用。
