MyBatis-Plus快速入门：八年Java老兵的效率实践指南

每次新建项目，都要写一堆重复的 Mapper 接口、XML 文件，光是一个简单的查询、新增功能，就要复制粘贴几十行代码；遇到分页、条件查询，还要手动拼 SQL，稍不注意就出语法错误；上线后想改个查询条件，既要改 XML 又要改接口，来回折腾半天……

你是不是也有过这种经历？明明是核心业务之外的重复工作，却占了开发时间的 30%；看着同事用 MyBatis-Plus 半小时搞定 CURD，自己却还在手写 XML，效率差了不止一倍。其实不是你技术不行，而是没找对工具 —— 今天就把我八年实战中总结的 Mybatis-Plus 快速入门指南分享给你，从环境搭建到高级用法，全程实战带代码，新手也能 1 小时上手，从此告别重复编码！

为什么 mybatis-Plus 能成为 Java 开发的效率神器？

先跟大家说组真实数据：我们团队之前用原生 MyBatis 开发，一个简单的 CURD 模块平均需要 2 天；引入 MyBatis-Plus 后，同样的需求 4 小时就能搞定，开发效率提升 80%，而且 SQL 错误率从 15% 降到了 1% 以下。

为什么 MyBatis-Plus 这么香？核心原因有 3 点：

1. 零侵入增强：完全基于 MyBatis 开发，不改变原有架构，直接无缝集成，老项目也能快速迁移；
2. 减少重复编码：内置 CRUD 接口，无需手写 Mapper 和 XML，一行代码搞定查询、新增、修改、删除；
3. 强大功能封装：分页插件、条件构造器、代码生成器等功能开箱即用，解决开发中 80% 的常见需求。

现在 MyBatis-Plus 已经成为 Spring Boot 项目的标配，据 2025 年技术选型报告，72% 的 java 后端项目都在使用 MyBatis-Plus—— 作为开发，掌握它不仅能提升工作效率，也是简历上的加分项。但很多新手觉得「配置复杂」「用法太多」，其实只要抓准核心流程，1 小时就能上手实战，下面就带大家一步步落地。

MyBatis-Plus 快速入门（4 步实战，附完整代码）第一步：环境搭建 ——3 分钟搞定依赖与配置

不管是新建 Spring Boot 项目，还是给老项目集成，MyBatis-Plus 的环境搭建都很简单，全程无需复杂配置：

1. 引入核心依赖（Maven 示例）

com.baomidoumybatis-plus-boot-starter3.5.5com.mysqlmysql-connector-jruntimecom.baomidoumybatis-plus-generator3.5.5org.freemarkerfreemarker

spring:datasource:url: jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=trueusername: root # 你的数据库用户名password: 123456 # 你的数据库密码driver-class-name: com.mysql.cj.jdbc.Driver# MyBatis-Plus配置（可选，按需配置）mybatis-plus:mapper-locations: classpath:mapper/*.xml # Mapper.xml文件路径（如果需要自定义SQL）type-aliases-package: com.example.demo.entity # 实体类包路径configuration:map-underscore-to-camel-case: true # 下划线转驼峰（默认开启）log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 打印SQL日志（开发环境推荐开启）

避坑提醒：

• 依赖版本要统一，避免 MyBatis-Plus 和 MyBatis 原生依赖冲突；

• 数据库 URL 要加上serverTimezone参数，否则会出现时区错误；

• 开发环境开启 SQL 日志，方便调试，生产环境建议关闭。

MyBatis-Plus 的核心优势就是「免手写 CRUD」，通过继承BaseMapper接口，就能直接使用内置方法，下面用用户表（user）为例实战：

1. 定义实体类（Entity）

import com.baomidou.mybatisplus.annotation.IdType;import com.baomidou.mybatisplus.annotation.TableId;import com.baomidou.mybatisplus.annotation.TableName;import lombok.Data;@Data // Lombok注解，简化getter/setter@TableName("user") // 对应数据库表名public class User {@TableId(type = IdType.AUTO) // 主键自增private Long id;private String username; // 用户名（对应数据库user_name字段，下划线转驼峰）private String password; // 密码private Integer age; // 年龄private String email; // 邮箱}

import com.baomidou.mybatisplus.core.mapper.BaseMapper;import com.example.demo.entity.User;import org.springframework.stereotype.Repository;@Repositorypublic interface UserMapper extends BaseMapper {// 无需写任何方法！BaseMapper已内置以下核心方法：// insert(T entity)：新增// deleteById(Serializable id)：根据ID删除// updateById(T entity)：根据ID修改// selectById(Serializable id)：根据ID查询// selectList(Wrapper queryWrapper)：条件查询// selectPage(Page page, Wrapper queryWrapper)：分页查询}

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;import com.example.demo.entity.User;import com.example.demo.mapper.UserMapper;import org.springframework.stereotype.Service;import javax.annotation.Resource;import java.util.List;@Servicepublic class UserService {@Resourceprivate UserMapper userMapper;// 1. 新增用户（一行代码）public boolean addUser(User user) {return userMapper.insert(user) > 0;// 2. 根据ID查询用户public User getUserById(Long id) {return userMapper.selectById(id);// 3. 条件查询（查询年龄>18的用户）public List getAdultUsers() {LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper().gt(User::getAge, 18); // 链式调用，无需手写SQLreturn userMapper.selectList(queryWrapper);// 4. 分页查询（第1页，每页10条）public Page getUserPage(int pageNum, int pageSize) {Page page = new Page<>(pageNum, pageSize);LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper().orderByDesc(User::getId); // 按ID降序return userMapper.selectPage(page, queryWrapper);}

效果对比：

• 原生 MyBatis：需要写 UserMapper 接口 + UserMapper.xml（至少 50 行代码）；

• MyBatis-Plus：只需定义接口继承 BaseMapper，无需写 XML，一行代码搞定 CRUD。

除了基础 CRUD，MyBatis-Plus 的这些高级用法能解决开发中 90% 的场景，八年老兵强烈推荐：

1. 代码生成器（5 分钟生成全套代码）

如果项目表多，手动写实体类、Mapper 太麻烦，用代码生成器一键生成：

import com.baomidou.mybatisplus.generator.FastAutoGenerator;import com.baomidou.mybatisplus.generator.config.OutputFile;import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;import java.util.Collections;public class CodeGenerator {public static void main(String[] args) {FastAutoGenerator.create("jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=Asia/Shanghai", "root", "123456").globalConfig(builder -> {builder.author("八年Java老兵") // 作者名.outputDir(System.getProperty("user.dir") + "/src/main/java") // 输出路径.disableOpenDir() // 生成后不打开文件夹.commentDate("yyyy-MM-dd"); // 注释日期.packageConfig(builder -> {builder.parent("com.example.demo") // 父包名.entity("entity") // 实体类包名.mapper("mapper") // Mapper包名.service("service") // Service包名.controller("controller") // Controller包名.pathInfo(Collections.singletonMap(OutputFile.mapperXml, System.getProperty("user.dir") + "/src/main/resources/mapper")); // Mapper.xml路径.strategyConfig(builder -> {builder.addInclude("user", "order") // 需要生成的表名（多个表用逗号分隔）.entityBuilder().enableLombok() // 实体类启用Lombok.mapperBuilder().enableBaseResultMap() // Mapper启用BaseResultMap.serviceBuilder().formatServiceFileName("%sService") // Service命名格式.controllerBuilder().enableRestStyle(); // Controller启用REST风格.templateEngine(new FreemarkerTemplateEngine()) // 使用Freemarker模板.execute();}

运行后会自动生成：实体类、Mapper 接口、Mapper.xml、Service、Controller，直接复用无需修改！

2. 条件构造器（复杂查询不用写 SQL）

遇到多条件查询，用LambdaQueryWrapper链式调用，支持所有 SQL 条件：

// 示例：查询年龄18-30岁、邮箱包含@qq.com、用户名不为空的用户LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper().between(User::getAge, 18, 30) // 年龄在18-30之间.like(User::getEmail, "@qq.com") // 邮箱包含@qq.com.isNotNull(User::getUsername); // 用户名不为空List userList = userMapper.selectList(queryWrapper);

MyBatis-Plus 分页插件开箱即用，只需添加配置类：

import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;@Configurationpublic class MyBatisPlusConfig {@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();// 添加分页插件（支持MySQL、Oracle等多种数据库）interceptor.addInnerInterceptor(new PaginationInnerInterceptor());return interceptor;}

之后调用selectPage方法即可实现分页，自动拼接limit语句，无需手动处理。

避坑指南

1. 表名 / 字段名映射问题：如果数据库表名是下划线命名（如 user_info），实体类要对应驼峰命名（UserInfo），或用@TableName指定表名；
2. 主键策略选择：自增主键用IdType.AUTO，分布式场景用IdType.ASSIGN_ID（雪花算法），避免主键冲突；
3. SQL 注入风险：使用 LambdaQueryWrapper 时，MyBatis-Plus 会自动防 SQL 注入，避免直接拼接字符串；
4. 性能优化：批量操作推荐用saveBatch（批量新增）、updateBatchById（批量修改），比循环调用单条方法效率高 10 倍；
5. 老项目迁移：如果已有原生 MyBatis 代码，只需将 Mapper 接口继承 BaseMapper，无需修改原有 XML，平滑过渡。

作为Java 老兵，MyBatis-Plus 是我用过最省心的开发工具 —— 它没有复杂的学习曲线，却能解决开发中最繁琐的重复工作，让我们从 CRUD 中解放出来，把时间花在核心业务和技术提升上。

今天分享的内容，从环境搭建、基础 CRUD 到高级用法、避坑指南，都是实战中最常用的核心知识点，配套的代码可以直接复制到项目中使用。如果能熟练掌握这些用法，你的开发效率至少能提升 50%，不管是日常开发还是面试，都是加分项。

现在就行动起来：打开你的项目，按照上面的步骤集成 MyBatis-Plus，尝试用它实现一个简单的 CURD 模块；如果遇到配置报错、用法疑问，欢迎在评论区留言，我会第一时间帮你解答！

最后想问：你之前用原生 MyBatis 开发时，遇到的最大痛点是什么？是手写 XML 太麻烦，还是分页查询不好实现？欢迎在评论区分享，我们一起交流更多 MyBatis-Plus 实战技巧！