MyBatis-Plus:安装指南 / 从零到运行
MyBatis-Plus 的安装实际上就是在一个 Java 项目(通常是 Spring Boot 项目)中,通过 Maven 引入它的核心依赖。它本身不是一个需要独立安装的软件,而是一个增强版的持久层框架,会在你的项目构建时被下载和引用。
一、核心安装步骤:引入 Maven 依赖
这是安装 MyBatis-Plus 最核心、最标准的一步。只需在你的 Spring Boot 项目的 pom.xml 文件中,加入以下依赖即可。
xml
<!-- MyBatis-Plus 核心依赖 --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> <!-- 请检查并使用当前最新稳定版本 --> </dependency>
关键说明:
无需再引入 MyBatis:mybatis-plus-boot-starter 已经包含了 MyBatis 的核心包,为避免版本冲突,建议移除项目中原本单独引入的 mybatis-spring-boot-starter。
选配依赖:如果后续需要使用代码生成功能,还需要额外引入 mybatis-plus-generator 和一个模板引擎(如 freemarker)。
二、数据库驱动与连接
MyBatis-Plus 需要配合具体的数据库驱动才能工作。以常用的 MySQL 为例,同样在 pom.xml 中引入驱动依赖:
xml
<!-- MySQL 数据库驱动 --> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency>
三、基本配置(application.yml)
依赖引入后,在 Spring Boot 的配置文件(application.yml 或 application.properties)中配置数据库连接和 MyBatis-Plus 的基本行为。
yaml
spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai username: root password: your_password mybatis-plus: # 实体类包路径,用于扫描实体别名(可选) type-aliases-package: com.example.yourproject.entity # Mapper XML 文件位置(如果有自定义SQL) mapper-locations: classpath*:/mapper/**/*.xml global-config: db-config: # 全局主键生成策略,这里设为自增 id-type: auto configuration: # 开启下划线到驼峰的自动映射 map-underscore-to-camel-case: true # 开发阶段开启SQL日志打印,方便调试 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
四、激活 Mapper 扫描
最后,需要在 Spring Boot 的启动类上添加 @MapperScan 注解,指定 Mapper 接口所在的包路径,这样 MyBatis-Plus 才能找到并生成这些接口的动态代理实现。
java
@SpringBootApplication @MapperScan("com.example.yourproject.mapper") // 替换为你的mapper包路径 public class YourApplication { public static void main(String[] args) { SpringApplication.run(YourApplication.class, args); } }
五、安装清单速查表
| 步骤 | 操作 | 关键说明 |
|---|---|---|
| 1. 引入核心依赖 | 在pom.xml添加mybatis-plus-boot-starter |
必须,版本建议用最新稳定版 |
| 2. 引入数据库驱动 | 在pom.xml添加数据库驱动,如mysql-connector-j |
根据实际使用的数据库选择 |
| 3. 配置文件 | 在application.yml中配置datasource和mybatis-plus |
包括连接信息、日志、主键策略等 |
| 4. 激活Mapper扫描 | 在启动类添加@MapperScan注解 |
指定Mapper接口的包路径,让框架识别 |
| 5. 创建测试Mapper | 编写一个继承BaseMapper的接口 |
无需写SQL,即可获得CRUD方法 |
安装完成后,你可以编写一个继承自 BaseMapper 的 Mapper 接口,即可体验 MyBatis-Plus 强大的单表 CRUD 能力,无需编写任何 SQL 和 XML 映射文件。
更多推荐

所有评论(0)