mybatis的xml映射文件应放在src/main/resources/mapper/目录下，并与mapper接口路径保持一致，如cn.example.dao.usermapper.xml对应usermapper接口；文件需包含正确的dtd声明和namespace命名空间，sql标签的id必须与接口方法名一致；在mybatis-config.xml中通过注册，或在spring boot的application.yml中配置mybatis.mapper-locations扫描路径；同时建议设置type-aliases-package简化类型定义；确保路径、命名、配置三者匹配即可正确加载。
MyBatis 的 XML 映射文件通常放在项目的 resources 目录下，与对应的 Mapper 接口保持路径一致，以便于管理和加载。
1. XML 文件存放位置
在典型的 Maven 项目结构中，MyBatis 的映射 XML 文件应放在：
src/main/resources/mapper/或者按照包结构组织，例如：
src/main/resources/cn/example/dao/UserMapper.xml这样可以和 Java 中的 Mapper 接口（如 cn.example.dao.UserMapper）对应起来，方便通过命名空间识别。
2. XML 映射文件基本结构
一个标准的 MyBatis 映射 XML 文件内容如下：
br> PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
INSERT INTO users(name, email) VALUES(#{name}, #{email})
3. 配置 MyBatis 加载映射文件
在 mybatis-config.xml 或 Spring/Spring Boot 配置中，需要指定映射文件的位置。
mybatis语法和介绍 中文WORD版
下载
本文档主要讲述的是mybatis语法和介绍；MyBatis 是一个可以自定义SQL、存储过程和高级映射的持久层框架。MyBatis 摒除了大部分的JDBC代码、手工设置参数和结果集重获。MyBatis 只使用简单的XML 和注解来配置和映射基本数据类型、Map 接口和POJO 到数据库记录。相对Hibernate和Apache OJB等“一站式”ORM解决方案而言，Mybatis 是一种“半自动化”的ORM实现。感兴趣的朋友可
如果是使用原生 MyBatis 配置，在 mybatis-config.xml 中添加：
如果使用 Spring Boot，推荐在配置文件 application.yml 中指定：
mapper-locations: classpath:mapper/**/*.xml
type-aliases-package: cn.example.entity
这样会自动扫描 resources/mapper 及其子目录下的所有 XML 映射文件。
4. 注意事项
确保以下几点避免常见问题：
- XML 文件路径和命名空间必须与 Mapper 接口匹配
- DTD 声明要正确，防止解析错误
- SQL 标签中的
id必须与接口方法名一致 - 使用 IDE 插件（如 MyBatisX）可提升开发效率
基本上就这些。只要路径对、命名对、配置对，MyBatis 就能正确加载 XML 映射文件。不复杂但容易忽略细节。
