MyBatis-Plus：安装指南 / 从零到运行

MyBatis-Plus 的安装实际上就是在一个 Java 项目通常是 Spring Boot 项目中通过 Maven 引入它的核心依赖。它本身不是一个需要独立安装的软件而是一个增强版的持久层框架会在你的项目构建时被下载和引用。一、核心安装步骤引入 Maven 依赖这是安装 MyBatis-Plus 最核心、最标准的一步。只需在你的 Spring Boot 项目的pom.xml文件中加入以下依赖即可。xml!-- MyBatis-Plus 核心依赖 -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.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 groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency三、基本配置application.yml依赖引入后在 Spring Boot 的配置文件application.yml或application.properties中配置数据库连接和 MyBatis-Plus 的基本行为。yamlspring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/your_database?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/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 才能找到并生成这些接口的动态代理实现。javaSpringBootApplication 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 映射文件。