mybatisx插件装不上需先确认idea版本≥2021.3且网络正常；版本过低则搜不到，网络异常可改用离线安装：下载对应版本.zip，通过settings→plugins→install plugin from disk安装并重启idea。
MyBatisX插件装不上？先确认IDEA版本和网络环境
MyBatisX 官方要求 IDEA 2021.3 及以上版本，低于该版本会显示「Incompatible」或根本搜不到。如果你用的是 2020.x 或更早版本，Plugins 页面搜 mybatisx 就是空白——不是操作错，是压根不支持。
网络问题更常见：公司内网、代理配置错误、JetBrains 插件仓库被限，都会导致搜索框无响应或一直转圈。此时别反复点「Search」，直接换离线安装：
- 去 JetBrains 官方插件页 下载最新
mybatisx.zip（注意选对应 IDEA 大版本的 build 号） - 在
Settings → Plugins → ⚙️ → Install plugin from disk…中选择该 zip 文件 - 安装后必须重启 IDEA，否则右键菜单里不会出现
MyBatisX选项
Database 工具窗口连不上数据库？MyBatisX 生成代码就卡住
MyBatisX 的「自动生成 Mapper/Entity」功能依赖 IDEA 内置的 Database 工具窗口连接真实数据库。如果没配好数据源，右键表时压根看不到 MyBatisX → Generate 菜单。
关键检查点：
- 确保已安装对应数据库驱动（如 MySQL 8 需
mysql-connector-j8.0+；IDEA 会提示下载，但若离线，需手动Download missing driver files或点击▶️旁的齿轮图标指定本地.jar） - URL 中
serverTimezone必须显式声明，MySQL 8 常见错误是The server time zone value 'XXX' is unrecognized，补上&serverTimezone=Asia/Shanghai即可 - 测试连接成功后，展开库 → 表，右键任意表，才会有
MyBatisX → Generate子菜单；若仍不出现，重启 IDEA 并重载项目
生成的 Entity 字段名不对？驼峰映射没生效
默认生成的 Java 字段名是下划线转驼峰（如 user_name → userName），但如果你发现字段全是全小写（username）或原样保留（user_name），说明未启用驼峰转换逻辑。
这不是 MyBatisX 插件 bug，而是生成模板或项目配置没对齐：
- 在
Generate对话框中，务必勾选Use Lombok（否则@Data不生效）并选择模板：mybatis-plus3模板才默认开启驼峰；mybatis3模板需手动勾选Enable camel case conversion - 生成后的
application.yml或application.properties中，确认有mybatis-plus.configuration.map-underscore-to-camel-case=true（MyBatis-Plus 项目）或mybatis.configuration.map-underscore-to-camel-case=true（原生 MyBatis） - 如果用了 Lombok，且字段生成为
private String user_name;，说明模板解析失败——检查表字段是否含特殊字符、空格或关键字，临时改名再试
Mapper 接口跳不到 XML？XML 里 Ctrl+Click 报错「Cannot find declaration」
这是 MyBatisX 最核心的功能，但失效率极高。根本原因不是插件没装，而是 XML 和接口的命名/路径/namespace 没严格匹配。
必须满足这三条，缺一不可：
-
Mapper接口类名必须与 XML 文件名完全一致（如UserMapper.java↔UserMapper.xml），且在同一 module 的src/main/java和src/main/resources下（路径可不同，但包名建议一致） - XML 文件顶部
<mapper namespace="com.example.mapper.UserMapper"></mapper>中的值，必须和接口的全限定名完全相同（大小写敏感，不能少package） - 接口中方法名必须与 XML 内
<select id="getById"></select>的id值一致；返回类型、参数类型也要能被插件静态推断（避免泛型擦除、Object等模糊声明）
最常被忽略的是：XML 文件未被 Maven/Gradle 当作资源文件处理。检查 pom.xml 是否漏了 <resources></resources> 配置，导致 *.xml 没打进 classpath —— 此时即使跳转显示正常，运行时也会报 Invalid bound statement。
