将SQL查询结果集直接转成XML，在数据交换、Web Service输出或生成配置文件等场景中几乎是刚需。SQL Server为此提供了FOR XML子句，其中RAW、AUTO、PATH是三种常用模式，而PATH模式因为能精确控制元素命名和嵌套结构，成为实际项目中最主流的选择。下面我们就从零开始，一步步拆解FOR XML PATH的用法，不仅要掌握基本语法，还会深入那些日常容易踩坑的细节。
FOR XML PATH 基础语法与简单用法
PATH模式的基本写法是在查询语句末尾加上FOR XML PATH('行元素名')，它会把SELECT列表里的每一列转换成XML子元素，每一行数据生成一个以指定名称为标签的行元素。如果省略括号里的名称，则行元素默认为row。
举个最简单的例子，我们有一张Students表，包含Id、Name和Age三个字段。想把所有学生数据输出为XML，可以这样写：
SELECT Id, Name, Age
FROM Students
FOR XML PATH('Student');
执行后得到的结果类似这样（为了便于阅读手动格式化）：
<Student> <Id>1</Id> <Name>张三</Name> <Age>20</Age> </Student> <Student> <Id>2</Id> <Name>李四</Name> <Age>22</Age> </Student>
这里每一列都变成了对应名称的子元素，整体没有根元素，这符合很多需要自行包裹根节点的场景。如果想要一个根元素，可以在最外层手动拼接，或者结合嵌套查询来生成。
注意PATH模式默认不会转义特殊字符，例如列值中包含<或>等字符时，输出结果中会保留原始字符，这可能导致生成的XML不合法。如果希望自动进行实体编码，可以使用FOR XML PATH(...), TYPE转换成XML类型，再由后续处理进行序列化，或者显式使用.value()方法。但对于大多数纯文本数据，直接用PAT模式就能满足。
自定义XML结构：列别名与元素/属性控制
PATH模式之所以称为灵活，很大程度上归功于它能通过列别名来干预生成的XML节点名称。别名里的点号、斜杠和@符号都有特定含义。例如，你想让Name列映射为StudentName元素，只需写Name AS "StudentName"。而如果需要把某列生成为元素的属性，就在别名前加上@符号。比如把Id作为Student元素的属性：
SELECT Id AS '@StudentId',
Name AS 'StudentName',
Age
FROM Students
FOR XML PATH('Student');
输出结果就会变成：
<Student StudentId="1"> <StudentName>张三</StudentName> <Age>20</Age> </Student>
可以看到，Id不再是子元素，而是作为了行元素的属性。这种写法在拼接具有属性结构的XML（如HTML片段、配置文件节点）时特别有用。
如果希望生成嵌套的子元素结构，可以在别名中使用斜杠/来划分层级。假设我们需要将Name放在BasicInfo元素下，可以写成Name AS "BasicInfo/Name"。更进一步，当列值为NULL时，默认情况下对应的元素不会出现。若希望保留空元素，可以使用ELEMENTS XSINIL指令配合ISNULL或者用空字符串产生空标签。但PATH模式下直接使用空字符串''或NULL搭配FOR XML PATH，通常会让该元素缺失，这一点在拼接字符串型XML时需要格外小心。
还有一个特别实用的技巧：当你不希望某个列的值作为一个独立元素，而是直接拼接到行元素的文本内容中时，可以把该列别名为*（星号）或者空字符串。例如想把Name直接作为Student元素的文本节点：
SELECT Name AS '*'
FROM Students
FOR XML PATH('Student');
这样每个Student元素内部就只有文本，不再产生<Name>标签。这个特性在生成逗号分隔列表或者拼接邮件内容时经常被使用。
实战：用FOR XML PATH拼接逗号分隔字符串
FOR XML PATH不仅能输出完整XML，还被广泛用于将多行数据合并成一个字符串，替代复杂的游标或自定义函数。比如你有一张Tags表，想按文章分组获取标签列表，用PAT模式配合空行元素名就能轻松实现。
示例：为每个文章生成以逗号分隔的标签字符串。
SELECT ArticleId,
STUFF((
SELECT ',' + TagName
FROM Tags t2
WHERE t2.ArticleId = t1.ArticleId
FOR XML PATH('')
), 1, 1, '') AS TagList
FROM (SELECT DISTINCT ArticleId FROM Tags) t1;
这里内部子查询通过FOR XML PATH('')把多个行拼接起来，列别名未定义，所以列值直接作为文本输出，逗号被手动添加在SELECT列表中。外部再用STUFF函数去掉最前面的多余逗号。这种方法比传统赋值循环或函数效率高得多，而且写法简洁。
需要提醒的是，如果标签文本中可能出现XML特殊字符，比如&或<，上述写法会直接保留原始字符，可能引起显示或解析问题。解决方案是在子查询中使用.value('.','nvarchar(max)')将XML转换回纯文本，并指定TYPE指令：
SELECT ArticleId,
(SELECT ',' + TagName
FROM Tags t2
WHERE t2.ArticleId = t1.ArticleId
FOR XML PATH(''), TYPE).value('.', 'nvarchar(max)') AS TagList
FROM (SELECT DISTINCT ArticleId FROM Tags) t1;
这样会触发XML实体编码，最终得到的字符串是已经转义过的安全内容。
嵌套查询与TYPE指令生成复杂XML树
绝大多数实际需求都不是简单的平坦结构，而是要求带有层级关系的XML，比如一份订单包含多个订单项，每个订单项又有自己的属性。FOR XML PATH配合子查询和TYPE指令，能生成完全符合目标模式的嵌套XML。
假设有Orders和OrderDetails两张表，需要输出如下结构：
<Order OrderId="1001">
<Customer>张三</Customer>
<Items>
<Item Product="钢笔" Quantity="2" />
<Item Product="笔记本" Quantity="1" />
</Items>
</Order>
可以利用子查询返回明细的XML片段，并用TYPE指令告诉外层这是XML数据类型，而不是被当成字符串再转义一次。
SELECT OrderId AS '@OrderId',
Customer,
(SELECT Product AS '@Product',
Quantity AS '@Quantity'
FROM OrderDetails d
WHERE d.OrderId = o.OrderId
FOR XML PATH('Item'), TYPE) AS 'Items'
FROM Orders o
FOR XML PATH('Order');
这里的关键是子查询后面加上了, TYPE，它保证内部结果以XML片段形式嵌入，否则会被视为字符串内容而执行实体化，结果就会出现一堆<转义字符。同样，如果你在子查询中再次嵌套子查询，每个层级都要记得加TYPE。
另外，可以用FOR XML PATH生成带有命名空间的XML，只需在根元素上声明xmlns即可。但PATH模式本身不直接支持命名空间前缀，需要通过WITH XMLNAMESPACES预先声明，然后配合FOR XML PATH使用。
掌握子查询嵌套和TYPE指令之后，你就能将任意复杂度的关系型数据映射为精确结构的XML，而不用在应用层再做二次拼接。
FOR_XML_PATHSQL_Server查询转XML修改时间：2026-08-12 07:21:43