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 或更高版本
必须在样式表根元素 或 中声明正确的命名空间和版本:
若用 Saxon、Altova、Oxygen 等支持 XSLT 2+/3.0 的处理器,该功能开箱即用;XSLT 1.0 不支持此指令,强行使用会报错。
基本语法与必需属性
xsl:result-document 至少需要指定 href 属性(目标文件路径),内容写在其内部模板中:
技术上面应用了三层结构,AJAX框架,URL重写等基础的开发。并用了动软的代码生成器及数据访问类,加进了一些自己用到的小功能,算是整理了一些自己的操作类。系统设计上面说不出用什么模式,大体设计是后台分两级分类,设置好一级之后,再设置二级并选择栏目类型,如内容,列表,上传文件,新窗口等。这样就可以生成无限多个二级分类,也就是网站栏目。对于扩展性来说,如果有新的需求可以直接加一个栏目类型并新加功能操作
-
href:可为静态字符串(如"output1.xml")或动态表达式(如concat('user-', $id, '.xml')),路径通常相对于主输出目录 - 可选
format:引用声明的 name,控制编码、缩进等 - 推荐加
method="xml"或method="html"等显式方法,避免依赖默认行为
常见实用场景示例
按节点拆分 XML 文件:遍历每个 ,为每个生成单独文件:
生成 HTML + CSS + JS 多文件:在同一个转换中分别输出页面、样式表和脚本:
注意事项与调试技巧
- 所有
xsl:result-document必须出现在顶层(即不在、内部?错误!它可在任何可执行上下文中,包括条件和循环内) - 文件路径不能包含非法字符;Windows 下注意反斜杠需转义为双反斜杠或用正斜杠
- 若输出失败(如路径无写入权限),多数处理器会抛出运行时错误,建议先测试单个文件
- Saxon 用户可配合
saxon:output扩展(XSLT 3.0 已标准化为xsl:result-document)









