如果你曾经使用过 MyBatis，你一定知道它的强大和灵活。然而，随着项目规模的增长，手写 SQL 成为了一件既繁琐又容易出错的事。这时，MyBatis-Plus（简称 MP）应运而生，它为 MyBatis 增强了许多功能，帮我们极大地提高开发效率。接下来，我们就来聊聊 MyBatis-Plus 的基本介绍和使用，让你轻松上手！
一、MyBatis-Plus 是什么？
MyBatis-Plus 是一款基于 MyBatis 的增强工具，它的口号是 “为简化开发而生”。简单来说，MP 在保留 MyBatis 灵活性的同时，帮我们封装了很多常用的功能，比如：
- 自动生成单表的 CRUD 操作，再也不用手写增删改查。
- 提供强大的 条件构造器，动态生成查询语句。
- 内置了 分页插件，让分页查询变得超级简单。
它适合那些既想要使用 ORM 工具，又希望对 SQL 有一定掌控力的开发者。
二、MyBatis-Plus 的核心特性
1. 开箱即用的 CRUD
MP 提供了 BaseMapper 接口，只需继承它，你就能获得所有单表的增删改查方法。例如：
UserMapper userMapper = ...; // Mapper 注入
User user = userMapper.selectById(1L); // 根据主键查询
就这么简单，一行代码搞定！
2. 强大的条件构造器
还记得那些复杂的 WHERE 条件 SQL 吗？MP 的条件构造器能帮你轻松搞定：
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.eq("age", 18).like("name", "Jack");
List<User> users = userMapper.selectList(queryWrapper);
动态查询再也不用拼接字符串了，是不是很香？
3. 分页插件
分页查询是开发中最常见的需求之一。MP 提供了内置的分页插件，只需简单配置，就可以用如下代码实现分页：
Page<User> page = new Page<>(1, 10); // 第1页，每页10条
Page<User> result = userMapper.selectPage(page, null);
System.out.println(result.getRecords()); // 当前页数据
System.out.println(result.getTotal()); // 总记录数
4. 自动代码生成器
如果你讨厌一遍遍写 Entity、Mapper、Service 的模板代码，MP 的代码生成器可以帮你一次性生成全部内容，让你专注于业务逻辑。
三、MyBatis-Plus 的快速入门
接下来，我们用一个简单的例子来说明如何使用 MyBatis-Plus。
1. 引入依赖
在你的项目中添加 MyBatis-Plus 的 Maven 依赖：
注意这里是以 Spring Boot 3 整合 MyBatis Plus，Spring Boot 2 的话要导入另一个包mybatis-plus-boot-starter
<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-spring-boot3-starter</artifactId><version>3.5.9</version>
</dependency>2. 配置数据源
在 application.yml 中配置数据源（以操作 MySQL 为例）和 MyBatis-Plus：
spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/test_dbusername: rootpassword: 123456mybatis-plus:configuration:log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 把sql语句打印到控制台
3. 创建实体类
假设我们的数据库中有一个 user 表，我们可以创建对应的实体类：
@Data // Lombok注解，生成一个JavaBean常用的方法
@TableName("user") // 指定绑定的数据表名
public class User {private Long id;private String name;private Integer age;private String email;
}
4. 创建 Mapper 接口
继承 BaseMapper 即可：
@Mapper
public interface UserMapper extends BaseMapper<User> {
}
5. 调用 CRUD 接口
在 Service 或 Controller 中使用：
@RestController
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserMapper userMapper;@GetMapping("/list")public List<User> listUsers() {return userMapper.selectList(null); // 查询所有用户}
}
运行后访问 /user/list，你会发现用户数据已经成功查询出来了！
确实，IService 是 MyBatis-Plus 提供的一种更高层次的接口封装，它将常用的业务逻辑操作进一步抽象，方便我们在 Service 层使用，避免直接操作 Mapper。下面补充关于 IService 和 ServiceImpl 的使用方法。
6. 使用 IService 接口实现业务逻辑
MyBatis-Plus 提供了 IService 和 ServiceImpl，帮我们在 Service 层简化基础逻辑操作，同时保持扩展性。
① 创建 Service 接口
继承 IService<T> 接口，定义业务逻辑层的接口：
public interface UserService extends IService<User> {// 自定义业务方法（如果有）
}
② 实现 Service 接口
创建实现类，继承 MyBatis-Plus 提供的 ServiceImpl 基类，自动注入 Mapper：
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {// 可以在这里扩展自定义的业务逻辑方法
}
③ 使用 Service
在 Controller 或其他业务类中注入 UserService，调用封装的 CRUD 方法：
@RestController
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserService userService;@GetMapping("/list")public List<User> listUsers() {return userService.list(); // 查询所有用户}@PostMapping("/add")public boolean addUser(@RequestBody User user) {return userService.save(user); // 新增用户}@DeleteMapping("/delete/{id}")public boolean deleteUser(@PathVariable Long id) {return userService.removeById(id); // 根据 ID 删除用户}
}
【IService 的优势】
-
抽象通用逻辑：将通用的 CRUD 方法（如
save、removeById、getById、list等）封装到接口中，避免每个 Service 重复实现。 -
Mapper 解耦：在业务层调用
IService提供的方法，无需直接操作 Mapper，增强了代码的层次性和可维护性。 -
可扩展性：如果有自定义业务逻辑，只需在
UserService接口和UserServiceImpl类中实现，无需修改基础代码。
7. 最佳实践
- 如果项目规模较小，直接使用
BaseMapper实现 CRUD，简单快捷。 - 如果项目复杂且需要 Service 层管理业务逻辑，建议使用
IService和ServiceImpl，规范代码结构。
四、为什么要用 MyBatis-Plus？
-
手写增删改查 SQL 的疲劳感：
想象一下，你有 10 个表，每个表都要写四五个基础操作的 SQL，是不是一想到就想摆烂？ -
动态拼接 SQL 的复杂性：
有些查询条件需要用户输入，这就意味着动态 SQL。手写拼接不仅代码冗长，而且容易出错。 -
分页查询的重复劳动：
传统分页查询需要写 SQL，还要计算总数。如果有工具自动搞定，岂不是省心又省力？
五、总结
MyBatis-Plus 是一款极大提升开发效率的工具，它不仅让我们摆脱了繁琐的基础代码编写，还提供了强大的功能来满足各种场景需求，我们可以在项目开发中更加专注业务逻辑，可以说是开发行云流水。通过今天的分享，相信你已经对 MP 有了初步的了解。
如果你对 MP 感兴趣，不妨动手尝试一下，亲自体验它的便捷性！之后，我会继续进一步展开来讲解开发中常用的部分，以及一些核心机制等内容，感兴趣的朋友可以关注留意一下噢！