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>

关键说明

无需再引入 MyBatismybatis-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中配置datasourcemybatis-plus 包括连接信息、日志、主键策略等
4. 激活Mapper扫描 在启动类添加@MapperScan注解 指定Mapper接口的包路径,让框架识别
5. 创建测试Mapper 编写一个继承BaseMapper的接口 无需写SQL,即可获得CRUD方法

安装完成后,你可以编写一个继承自 BaseMapper 的 Mapper 接口,即可体验 MyBatis-Plus 强大的单表 CRUD 能力,无需编写任何 SQL 和 XML 映射文件。

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐