MyBatis的XML映射文件应放在src/main/resources/mapper/目录下，并与Mapper接口路径保持一致，如cn.example.dao.UserMapper.xml对应UserMapper接口；文件需包含正确的DTD声明和namespace命名空间，SQL标签的id必须与接口方法名一致；在mybatis-config.xml中通过<mapper resource="..."/>注册，或在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 文件内容如下：
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.example.dao.UserMapper"> <!-- 对应 Mapper 接口全限定名 -->
<select id="selectUserById" resultType="cn.example.entity.User">
SELECT * FROM users WHERE id = #{id}
</select>
<insert id="insertUser" parameterType="cn.example.entity.User">
INSERT INTO users(name, email) VALUES(#{name}, #{email})
</insert>
</mapper>
3. 配置 MyBatis 加载映射文件
在 mybatis-config.xml 或 Spring/Spring Boot 配置中，需要指定映射文件的位置。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
如果是使用原生 MyBatis 配置，在 mybatis-config.xml 中添加：
<mapper resource="cn/example/dao/UserMapper.xml" />
</mappers>
如果使用 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 映射文件。不复杂但容易忽略细节。
