新手别慌！MyBatis 的 include 标签真的不用纠结顺序

刚学 MyBatis 时，我也曾对着映射文件抓耳挠腮：明明 include 引用了某个 sql 片段，可把片段放在后面就报错了？后来才发现------ 根本不是顺序的问题！MyBatis 早就帮我们搞定了。

一、include 标签到底是啥？新手也能秒懂

其实就是 SQL 代码的「复制粘贴小助手」。比如你总写 id, username, email 这串字段，烦不烦？用定义一次，以后用引用就行，超省事儿！

xml 复制代码

<!-- 定义一个字段列表片段 -->
<sql id="userColumns">id, username, email</sql>

<!-- 引用这个片段 -->
<select id="getUser" resultType="User">
  SELECT <include refid="userColumns"/> FROM user WHERE id 
  = #{id}
</select>

就像你把常用短语存在手机备忘录里，要用时直接复制，不用再重复打字------就这么简单！

二、顺序真的不重要？MyBatis 有「超能力」

新手最容易纠结：片段（B 标签）必须放在引用它的地方（A 标签）前面吗？

答案：完全不用！因为 MyBatis 读映射文件时，会干两件事：

第一步：先「扫一遍」记下来所有片段

MyBatis 像个细心的图书管理员，拿到文件先从头到尾翻一遍，把所有标签的 id 和内容都记在小本本上（相当于建了个「片段字典」）。

哪怕你在文件开头就引用了一个后面才定义的片段，它也不会急着报错，而是继续往后翻，直到找到那个片段并记下来。

第二步：再「回头」替换所有引用

等把所有片段都记全了，MyBatis 才会重新看一遍文件，遇到就去「片段字典」里找对应的内容，替换进去。

这就像你先把拼图的所有碎片都找出来摆好，再开始拼------不管碎片是先拿出来的还是后拿出来的，只要最后都找到了，就能拼出完整的图！

三、亲手试试：片段放后面真的能跑

来，咱们写个「反直觉」的代码试试：

sql 复制代码

<!-- 先引用片段 -->
<select id="getUser" resultType="User">
  SELECT <include refid="userColumns"/> FROM user WHERE id 
  = #{id}
</select>

<!-- 后定义片段 -->
<sql id="userColumns">id, username, email</sql>

你猜怎么着？这段代码真的能正常运行！MyBatis 会先扫到，然后继续往后扫，找到并记下来，最后再回来替换，完美运行～

四、新手建议：舒服最重要，别跟自己较劲

虽然 MyBatis 不挑顺序，但作为新手，我还是想啰嗦几句：

简单场景：先定义后引用更顺手刚开始学的时候，把片段放在引用它的 SQL 前面，符合我们「先看到定义再看到使用」的习惯，不容易搞混。
复杂场景：按功能分组更清晰如果文件里有很多片段，不妨按功能分组（比如「用户相关片段」「订单相关片段」），放在一起，找起来更方便。
千万记住：别搞循环引用！要是出现「A 引用 B，B 又引用 A」的情况，MyBatis 就懵了，会报错的！就像两个人互相问对方借字典，结果谁都没字典，尴尬～

总结

MyBatis 的标签真的很贴心，不管片段放在哪里，它都能正确找到。作为新手，咱们不用纠结顺序，怎么舒服怎么写！

刚开始可以先「先定义后引用」，熟悉了之后，完全可以按自己的习惯组织代码------毕竟，工具是为人服务的，不是吗？