开发环境搭建

MyBatis 开发环境配置简洁，下面梳理核心步骤。

Maven 依赖配置

核心依赖

在 pom.xml 中添加 MyBatis 与数据库驱动依赖：

<dependencies>
    <!-- MyBatis 核心包 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.16</version>
    </dependency>
    
    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <version>8.0.33</version>
    </dependency>
    
    <!-- 日志包 -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-api</artifactId>
        <version>2.0.9</version>
    </dependency>
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.4.14</version>
    </dependency>
</dependencies>

注意：MyBatis 3.5.x 要求 JDK 8+，MySQL 8.x 驱动兼容 MySQL 5.7+。

项目目录结构

mybatis-demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/
│   │   │       ├── entity/User.java
│   │   │       ├── mapper/UserMapper.java
│   │   │       └── Main.java
│   │   └── resources/
│   │       ├── mybatis-config.xml
│   │       ├── db.properties
│   │       └── mapper/
│   │           └── UserMapper.xml
│   └── test/
└── pom.xml

核心配置文件

mybatis-config.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!-- 引入外部属性文件 -->
    <properties resource="db.properties"/>
    
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${db.driver}"/>
                <property name="url" value="${db.url}"/>
                <property name="username" value="${db.username}"/>
                <property name="password" value="${db.password}"/>
            </dataSource>
        </environment>
    </environments>
    
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>

db.properties

db.driver=com.mysql.cj.jdbc.Driver
db.url=jdbc:mysql://localhost:3306/mybatis_demo?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
db.username=root
db.password=123456

注意：外部化配置便于多环境切换，避免硬编码敏感信息。

验证环境

// Main.java
public class Main {
    public static void main(String[] args) throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        
        try (SqlSession session = sqlSessionFactory.openSession()) {
            System.out.println("MyBatis 环境搭建成功！");
        }
    }
}

要点总结

• Maven 引入 MyBatis 核心包、数据库驱动、日志包
• 项目结构清晰，分离 Java 代码与 XML 配置
• 使用 db.properties 外部化数据库配置
• 通过 SqlSessionFactoryBuilder 验证环境是否成功

文章存放路径：articles/MYBATIS/入门/MyBatis 概述与环境搭建/开发环境搭建.md