如何用XSLT生成多个输出文件 xsl:result-document

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 属性（目标文件路径），内容写在其内部模板中：

• href：可为静态字符串（如 "output1.xml"）或动态表达式（如 concat('user-', $id, '.xml')），路径通常相对于主输出目录
• 可选 format：引用
  声明的 name，控制编码、缩进等
• 推荐加 method="xml" 或 method="html" 等显式方法，避免依赖默认行为

常见实用场景示例

按节点拆分 XML 文件：遍历每个 ，为每个生成单独文件：

  
    
  

生成 HTML + CSS + JS 多文件：在同一个转换中分别输出页面、样式表和脚本：

body { margin: 0; }
console.log("loaded");
...

注意事项与调试技巧

• 所有 xsl:result-document 必须出现在顶层（即不在 、 内部？错误！它可在任何可执行上下文中，包括条件和循环内）
• 文件路径不能包含非法字符；Windows *意反斜杠需转义为双反斜杠或用正斜杠
• 若输出失败（如路径无写入权限），多数处理器会抛出运行时错误，建议先测试单个文件
• Saxon 用户可配合 saxon:output 扩展（XSLT 3.0 已标准化为 xsl:result-document）