MyBatis 与 MyBatis-Plus 的详细区别

MyBatis 和 MyBatis-Plus 都是 Java 生态中广泛使用的持久层框架，旨在简化数据库操作。MyBatis-Plus 是在 MyBatis 基础上构建的增强工具，两者在功能、开发效率和使用体验上存在显著差异。以下从多个维度进行详细对比。

1. 功能定位与扩展性

• MyBatis

  • 核心定位：一个半自动化的 ORM 框架，专注于 SQL 与 Java 对象的映射。
  • 功能特点：提供了强大而灵活的方式操作数据库，支持编写自定义 SQL、调用存储过程以及实现复杂的高级结果集映射。它赋予开发者对 SQL 的完全控制权，非常适合复杂、定制化的查询场景。

• MyBatis-Plus

  • 核心定位：MyBatis 的增强工具包，旨在简化开发、提高效率。
  • 功能特点：在保留 MyBatis 所有特性的基础上，内置了大量开箱即用的功能，如通用 CRUD、多种条件构造器、分页插件、代码生成器等，极大地减少了开发者的模板代码编写量。

2. CRUD 操作的实现方式

• MyBatis

  • 需要开发者手动编写每一个增删改查操作的 SQL 语句（在 XML 文件或注解中），并配置对应的参数映射和结果映射。
  • 优点：灵活、精准，能应对所有 SQL 场景。
  • 缺点：对于简单的单表操作，会产生大量重复性代码。

• MyBatis-Plus

  • 提供了通用的 BaseMapper 接口，只需让您的 Mapper 继承该接口，即可直接获得一系列内置方法（如 insert, selectById, update, deleteById 等），无需编写任何 SQL 即可完成基本操作。
  • 配套提供强大的 代码生成器，可一键生成实体类、Mapper 接口、Service、Controller 以及基础的 XML 文件，进一步提升开发速度。

3. 查询条件构建

• MyBatis

  • 构建动态查询条件通常需要在 XML 中使用 <if>, <choose>, <foreach> 等标签拼接 SQL 片段，或者在 Java 代码中拼接 SQL 字符串，过程较为繁琐且不易维护。

• MyBatis-Plus

  • 提供了非常直观的 条件构造器（Wrapper），例如 QueryWrapper、LambdaQueryWrapper、UpdateWrapper。
  • 可以通过链式调用的方式，以面向对象的形式构建查询条件，代码可读性高，且能有效防止 SQL 注入。

  • 示例：

    // 查询年龄大于18且姓“张”的用户
    QueryWrapper<User> wrapper = new QueryWrapper<>();
    wrapper.gt("age", 18).likeRight("name", "张");
    List<User> userList = userMapper.selectList(wrapper);
    
    // 使用Lambda表达式，更安全（避免字段名拼写错误）
    LambdaQueryWrapper<User> lambdaWrapper = new LambdaQueryWrapper<>();
    lambdaWrapper.gt(User::getAge, 18).likeRight(User::getName, "张");

4. 分页功能

• MyBatis

  • 原生支持有限，通常需要开发者自己编写 LIMIT 语句或使用第三方分页插件（如 PageHelper）来实现物理分页。

• MyBatis-Plus

  • 内置了成熟、易用的 分页插件（PaginationInterceptor）。
  • 配置后，只需传入一个 Page 对象作为参数，即可自动完成分页查询和总记录数统计，支持多种数据库方言。
  • 示例：

    Page<User> page = new Page<>(1, 10); // 查询第1页，每页10条
    IPage<User> userPage = userMapper.selectPage(page, queryWrapper);
    List<User> records = userPage.getRecords(); // 当前页数据
    long total = userPage.getTotal(); // 总记录数

5. 性能与扩展插件

• MyBatis

  • 拥有一套插件机制（Interceptor），可以用于实现自定义功能，如 SQL 日志打印、执行时间监控、数据脱敏等。社区也有丰富的第三方插件。

• MyBatis-Plus

  • 在 MyBatis 插件机制的基础上，提供了更多内置的、针对性的优化插件：
    • 性能分析插件：输出 SQL 语句及其执行时间，帮助定位慢查询。
    • 乐观锁插件：通过 @Version 注解轻松实现乐观锁，解决并发更新问题。
    • 动态表名插件：支持在运行时动态切换表名，适用于分表场景。
    • SQL 注入器：允许自定义全局通用方法，如“逻辑删除”、“自动填充”等。

6. 使用场景与总结

结论：
MyBatis-Plus 并非要替代 MyBatis，而是作为其强大的“增强包”。如果你的项目追求极致的开发效率，且业务以常规的 CRUD 为主，MyBatis-Plus 是更优的选择。如果你的项目涉及大量复杂的存储过程、动态 SQL 或对 SQL 性能有极致要求，需要完全掌控每一行 SQL 代码，那么原生 MyBatis 可能更适合。两者可以结合使用，在 MyBatis-Plus 项目中，你依然可以完全使用原生 MyBatis 的方式编写复杂 SQL，兼顾效率与灵活性。