xsl:result-document是XSLT 2.0+原生支持多文件输出的核心指令,需声明version="2.0"及以上,href为必需属性,可在任意可执行上下文中使用,适用于按节点拆分、生成HTML/CSS/JS等场景。

使用 xsl:result-document 可以在一次XSLT转换过程中生成多个独立的输出文件,这是XSLT 2.0及以上版本(包括XSLT 3.0)的核心功能,原生支持多文件输出,无需依赖处理器扩展。
确保使用 XSLT 2.0 或更高版本
必须在样式表根元素 <xsl:stylesheet> 或 <xsl:transform> 中声明正确的命名空间和版本:
若用 Saxon、Altova、Oxygen 等支持 XSLT 2+/3.0 的处理器,该功能开箱即用;XSLT 1.0 不支持此指令,强行使用会报错。
基本语法与必需属性
xsl:result-document 至少需要指定 href 属性(目标文件路径),内容写在其内部模板中:
-
href:可为静态字符串(如"output1.xml")或动态表达式(如concat('user-', $id, '.xml')),路径通常相对于主输出目录 - 可选
format:引用<xsl:output>声明的 name,控制编码、缩进等 - 推荐加
method="xml"或method="html"等显式方法,避免依赖默认行为
常见实用场景示例
按节点拆分 XML 文件:遍历每个 <item>,为每个生成单独文件:
<xsl:result-document href="{concat('item-', @id, '.xml')}" method="xml">
<item><xsl:copy-of select="."/></item>
</xsl:result-document>
</xsl:for-each>
生成 HTML + CSS + JS 多文件:在同一个转换中分别输出页面、样式表和脚本:
<xsl:result-document href="style.css" method="text">body { margin: 0; }</xsl:result-document><xsl:result-document href="script.js" method="text">console.log("loaded");</xsl:result-document>
<xsl:result-document href="index.html" method="html"><html>...</html></xsl:result-document>
注意事项与调试技巧
- 所有
xsl:result-document必须出现在顶层(即不在<xsl:if>、<xsl:for-each>内部?错误!它可在任何可执行上下文中,包括条件和循环内) - 文件路径不能包含非法字符;Windows 下注意反斜杠需转义为双反斜杠或用正斜杠
- 若输出失败(如路径无写入权限),多数处理器会抛出运行时错误,建议先测试单个文件
- Saxon 用户可配合
saxon:output扩展(XSLT 3.0 已标准化为xsl:result-document)










