baomidou /mybatis-plus
An powerful enhanced toolkit of MyBatis for simplify development
★ 17,484⑂ 4,433👁 79⑃ 1,213● 5,818▤ 43
-1
日增长
17,484
stars
4,433
forks
79
watchers
1,213
prs
5,818
issues
43
releases
README
为简化开发工作、提高生产率而生
企业版 Mybatis-Mate 高级特性
简介 | Intro
Mybatis 增强工具包 - 只做增强不做改变,简化CRUD操作
添加 微信 wx153666 备注进 mp 群
不允许非法项目使用,后果自负
特别用户
依赖引用
Latest Version:
根据项目使用的 Spring Boot 版本选择对应的 Starter,将 Latest Version 替换为所需的 MyBatis-Plus 版本。
Spring Boot 4
需要 MyBatis-Plus 3.5.13 及以上版本。
Maven:
xml
com.baomidou
mybatis-plus-spring-boot4-starter
Latest Version
Gradle:
groovy
implementation 'com.baomidou:mybatis-plus-spring-boot4-starter:Latest Version'
测试依赖(按需引入)
使用 @MybatisPlusTest 编写测试时,引入对应的测试 Starter,版本与上述 Starter 保持一致。
Maven:
xml
com.baomidou
mybatis-plus-spring-boot4-starter-test
Latest Version
test
Gradle:
groovy
testImplementation 'com.baomidou:mybatis-plus-spring-boot4-starter-test:Latest Version'
Spring Boot 3
Maven:
xml
com.baomidou
mybatis-plus-spring-boot3-starter
Latest Version
Gradle:
groovy
implementation 'com.baomidou:mybatis-plus-spring-boot3-starter:Latest Version'
测试依赖(按需引入)
使用 @MybatisPlusTest 编写测试时,引入对应的测试 Starter,版本与上述 Starter 保持一致。
Maven:
xml
com.baomidou
mybatis-plus-spring-boot3-starter-test
Latest Version
test
Gradle:
groovy
testImplementation 'com.baomidou:mybatis-plus-spring-boot3-starter-test:Latest Version'
Spring Boot 2
Maven:
xml
com.baomidou
mybatis-plus-boot-starter
Latest Version
Gradle:
groovy
implementation 'com.baomidou:mybatis-plus-boot-starter:Latest Version'
测试依赖(按需引入)
使用 @MybatisPlusTest 编写测试时,引入对应的测试 Starter,版本与上述 Starter 保持一致。
Maven:
xml
com.baomidou
mybatis-plus-boot-starter-test
Latest Version
test
Gradle:
groovy
testImplementation 'com.baomidou:mybatis-plus-boot-starter-test:Latest Version'
SQL 解析依赖(按需引入)
从 MyBatis-Plus 3.5.9 开始,使用分页等依赖 SQL 解析的插件时,需要额外引入以下解析模块之一。请选择一个与 JDK 及所需 JSqlParser 版本匹配的模块,并与 Starter 保持相同的 MyBatis-Plus 版本。
下表中的 JSqlParser 版本以当前仓库的依赖配置为准;使用其他 MyBatis-Plus 版本时,请以对应发布版本的依赖为准。
| MyBatis-Plus 模块 | JSqlParser 版本 | JDK 要求 |
| --- | --- | --- |
| mybatis-plus-jsqlparser | 5.4 | JDK 11+ |
| mybatis-plus-jsqlparser-5.2 | 5.2 | JDK 11+ |
| mybatis-plus-jsqlparser-5.0 | 5.0 | JDK 11+ |
| mybatis-plus-jsqlparser-4.9 | 4.9 | JDK 8+ |
以下以 mybatis-plus-jsqlparser 为例;使用其他 JSqlParser 版本时,将模块名替换为上表中的对应模块即可。
Maven:
xml
com.baomidou
mybatis-plus-jsqlparser
Latest Version
Gradle:
groovy
implementation 'com.baomidou:mybatis-plus-jsqlparser:Latest Version'
优点 | Advantages
- 无侵入:Mybatis-Plus 在 Mybatis 的基础上进行扩展,只做增强不做改变,引入 Mybatis-Plus 不会对您现有的 Mybatis
构架产生任何影响,而且 MP 支持所有 Mybatis 原生的特性
- 依赖少:仅仅依赖 Mybatis 以及 Mybatis-Spring
- 损耗小:启动即会自动注入基本CURD,性能基本无损耗,直接面向对象操作
- 通用CRUD操作:内置通用 Mapper、通用 Service,仅仅通过少量配置即可实现单表大部分 CRUD 操作,更有强大的条件构造器,满足各类使用需求
- 多种主键策略:支持多达4种主键策略(内含分布式唯一ID生成器),可自由配置,完美解决主键问题
- 支持ActiveRecord:支持 ActiveRecord 形式调用,实体类只需继承 Model 类即可实现基本 CRUD 操作
- 支持代码生成:采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller
层代码,支持模板引擎,更有超多自定义配置等Top issues
#6374[功能改进]: 4.0 希望支持功能建议收集81 comments · 2024-08-06#61864.x版本改造11 comments · 2024-05-21#7148[错误报告]: Error setting non null for parameter #1 with JdbcType null .7 comments · 2026-07-13#6430DataChangeRecorderInnerInterceptor插件Bug归档处理6 comments · 2024-08-23#6246kotlin下使用对象当做别名去引用属性传入Compare的方法无法编译通过了5 comments · 2024-06-08#7162[错误报告]: Gbase数据库驱动不支持方法 : IfxStatement.closeOnCompletion()错误4 comments · 2026-07-29#6188解决BaseMapper批量操作二级缓存清理问题3 comments · 2024-05-21#7183[功能改进]: 支持 PolarDB-Oracle 数据库2 comments · 2026-10-12
Latest release
v3.5.18.1 v3.5.18.1 2026-10-27- fix: isolate starter configurations and adapt Spring Boot 4 - fix: correct test convention source scanning - fix: 修复全表操作拦截器 OR 条件空指针 (7195) - opt: check formatting before build - opt: 优化格式化多数据源相关代码