MyBatis的<sql>标签用于定义可复用SQL片段，配合<include>引用，避免重复书写列名或条件逻辑；需定义唯一id、仅含合法SQL表达式（如字段列表），且须在同一Mapper或通过namespace跨文件引用。
MyBatis 的 `
定义通用列名片段
在 Mapper XML 中，用 `
例如：
<sql id="baseColumns">id, name, email, created_time, status
</sql>
在查询中通过 `` 引入列名
在 `
立即学习“Java免费学习笔记（深入）”；
示例：
<select id="selectAll" resultType="User">SELECT
<include refid="baseColumns"/>
FROM user
</select>
支持参数化列名（带别名或动态字段）
如果需要根据不同场景调整列名（如加表别名、排除某些字段），可以用 `
例如，定义带别名的列：
<sql id="userColumnsWithAlias">u.id, u.name, u.email, u.created_time, u.status
</sql>
然后在查询中引用：
<select id="selectUserWithJoin" resultType="UserWithDept">SELECT
<include refid="userColumnsWithAlias"/>, d.name as dept_name
FROM user u
LEFT JOIN dept d ON u.dept_id = d.id
</select>
注意事项与常见问题
- `
` 标签必须定义在同一个 Mapper XML 文件内，或被 ` ` 引入的外部文件中；跨 namespace 需用 `namespace.id` 形式引用，如 `com.example.UserMapper.baseColumns` - 不要在 `
` 内写 `SELECT` 或 `FROM`，只放字段列表、WHERE 条件片段等纯表达式部分 - 若 `
` 展开后导致 SQL 语法错误（比如多出逗号、缺空格），检查 ` ` 内容是否包含意外换行或空格——建议把所有内容写在同一行，或用 ` ` 控制前后空白 - IDE（如 IntelliJ）可能无法识别 `
` 的跳转，但不影响运行；可通过插件（如 MyBatisX）增强支持
