mybatis 的 和 是实现 xml 中动态 sql 片段复用的核心机制，通过 定义无顶层关键字的可参数化片段，再用 引入并支持 property 传参，实现安全、模块化、可嵌套的 sql 复用。

MyBatis 的 `` 和 `` 是实现 XML 中动态 SQL 片段复用的核心机制，关键在于定义可参数化、可嵌套、可组合的 SQL 片段，并在 ``、`` 等标签中安全引用。

定义可复用的 `` 片段

使用 `` 标签封装常用字段、条件或 JOIN 逻辑，支持 ``、`` 等动态标签，但**不能包含顶层 SQL 关键字（如 SELECT、WHERE）**，仅作为“片段”存在。推荐按语义命名，例如：

  id, username, email, status, create_time



  
    AND username LIKE CONCAT('%', #{username}, '%')
  
  
    AND status = #{status}
  

在语句中用 `` 引入并传递参数

`` 支持 `refid` 指向 `` 片段，还可通过 `` 向片段内传递变量（常用于重命名参数或适配不同上下文）：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

  SELECT
  
  FROM user
  WHERE 1=1
  
    
    
  

注意：`` 中的 `name` 必须与 `` 片段里 `test` 表达式中的变量名一致（如 `username`），而 `value` 可以是任意合法 OGNL 表达式，实现参数解耦。

嵌套 `` 与作用域注意事项

一个 `` 片段可以 `` 另一个 ``，形成模块化结构，但需注意：

• 所有 `` 展开后必须构成语法合法的 SQL —— 例如不要在 `` 片段里写 `WHERE`，除非你确定每次引入都处于 WHERE 子句位置
• 参数作用域是扁平的：被 `` 的片段直接访问外层传入的参数对象（如 `#{id}`），无需额外声明；`` 是覆盖/补充方式，非必需
• ID 全局唯一：`` 的 id 在整个 Mapper XML 中不能重复，否则启动报错

实战技巧：避免常见陷阱

• 别在 `` 里写分号或注释 —— MyBatis 不解析 SQL 注释，且分号可能破坏语句结构
• 复杂条件建议拆成多个 ``，比如 `base_condition`、`admin_only_condition`，再组合使用，提升可读性与复用率
• 字段列表尽量用 `` 封装，尤其涉及多表 JOIN 或结果映射时，避免硬编码导致 `resultMap` 维护脱节
• 如果片段需区分 INSERT/UPDATE 字段（如排除主键或时间戳），可用 `` 或自定义属性判断执行上下文

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南