baomidou /mybatis-plus

An powerful enhanced toolkit of MyBatis for simplify development

★ 17,484⑂ 4,433👁 79⑃ 1,213● 5,818▤ 43
JavaApache-2.0Created 2016-08-18baomidou.com
下载:v3.5.18.1v3.5.18.1 ↓3.5.18.12026-10-27
-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

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: 优化格式化多数据源相关代码

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON