MyBatis XML映射文件以<mapper>为根元素，需声明对应接口全限定名的namespace；通过<select>、<insert>等标签定义SQL，id匹配方法名，#{xxx}安全传参，<resultMap>处理字段映射与关联查询，<sql>与<include>实现SQL复用。
MyBatis 的 XML 映射文件（Mapper XML）是用来定义 SQL 语句和结果映射的核心配置，它把 Java 接口方法和数据库操作解耦，让 SQL 更清晰、可维护性更强。
XML 文件基本结构和命名规范
每个 Mapper XML 文件需对应一个接口（如 UserMapper.java），文件名建议与接口同名（UserMapper.xml），并放在相同包路径下（或通过 <mappers> 显式注册）。根元素必须是 <mapper>，且必须声明 namespace，值为对应接口的全限定类名：
<!-- SQL 映射标签写在这里 -->
</mapper>
常用 SQL 标签怎么写
核心标签包括 <select>、<insert>、<update>、<delete>，每个标签用 id 属性对应接口中的方法名，用 parameterType 指定入参类型（可省略，MyBatis 能自动推断），用 resultType 或 resultMap 指定返回类型：
-
简单查询：
<select id="findById" resultType="User">SELECT * FROM user WHERE id = #{id}</select> -
带条件插入：
<insert id="save" parameterType="User">INSERT INTO user(name, age) VALUES(#{name}, #{age})</insert> -
动态更新：用
<set>+<if>避免逗号和 SET 关键字冗余：
<update id="update">
UPDATE user
<set>
<if test="name != null">name = #{name},</if>
<if test="age != null">age = #{age}</if>
</set>
WHERE id = #{id}
</update>
结果映射（resultMap）怎么配
当列名和属性名不一致，或需要嵌套查询（一对一、一对多）时，要用 <resultMap>。先定义 ID，再用 <id>（主键）、<result>（普通字段）做映射；复杂关系用 <association>（一对一）或 <collection>（一对多）：
<id property="id" column="user_id"/>
<result property="name" column="user_name"/>
<collection property="orders" ofType="Order" select="selectOrdersByUserId" column="user_id"/>
</resultMap>
注意：select 属性指向另一个 <select> 的 id，实现延迟加载（需开启 lazyLoadingEnabled）。
SQL 片段复用与参数处理
用 <sql> 标签抽取可复用的 SQL 片段（如公共字段列表），再用 <include> 引入；参数占位统一用 #{xxx}（预编译防注入），仅在极少数场景（如 ORDER BY 字段）才用 ${xxx}（字符串拼接，需自行校验）：
- 定义片段：
<sql id="userColumns">id, name, age, create_time</sql> - 引用片段：
<select id="listAll">SELECT <include refid="userColumns"/> FROM user</select> - 安全传参：
WHERE status = #{status}✅；ORDER BY ${sortBy}⚠️（确保 sortBy 是白名单值）
