xsl:result-document 是 XSLT 2.0+ 中用于生成多个独立输出文件的核心指令，通过 href 指定路径，配合循环动态创建文件，并支持 method、encoding、indent 等属性定制格式。

xsl:result-document 是 XSLT 2.0 及以上版本中用于生成**多个输出文件**的核心指令。它不依赖于主输出（即模板默认输出到 stdout 或单个文件），而是允许你在转换过程中主动创建任意数量的独立结果文档。

基本用法：指定 href 生成新文件

最常见的方式是用 href 属性指定目标文件路径：

• 路径可以是相对路径（如 "output/chapter1.html"）或绝对路径（如 "/tmp/report.xml"）
• 路径支持动态构造，比如用 {@id}、{position()} 或函数拼接
• 每个 xsl:result-document 必须包含一个顶层元素（如 或 ），不能只写文本或属性

配合 xsl:for-each 或 xsl:apply-templates 批量生成

要为每个源节点生成一个文件，通常嵌套在循环或模板调用中：

• 例如，把每个
  输出为单独 HTML 文件：
  
    
      
  
    
  
• 注意：xsl:result-document 本身不改变当前上下文，所以内部仍可用 . 指代当前被遍历的节点

控制输出格式和编码（可选但实用）

通过 method、encoding、indent 等属性定制每个文件：

• method="html" → 输出为 HTML（自动省略 XML 声明）
• encoding="UTF-8" → 显式指定编码，避免乱码
• indent="yes" → 让生成的 XML/HTML 更易读（仅对 XML/HTML method 有效）
• 这些属性写在 xsl:result-document 开始标签内，不影响其他文件

注意事项和常见坑

实际使用时容易出错的地方：

• 必须用 XSLT 2.0+ 处理器（如 Saxon-HE、Saxon-PE、Saxon-EE；Xalan、libxslt 不支持）
• href 值不能为空或纯空白，否则报错；建议用 normalize-space() 预处理
• 路径中的非法字符（如 / \ : * ? " |）需转义或替换，尤其在 Windows 下
• 多个 xsl:result-document 可以共存，但不能嵌套——它只能是顶层指令，不能放在 xsl:if 或 xsl:for-each 的子元素之外

基本上就这些。只要处理器支持、路径合法、内容结构完整，生成多个文件并不复杂，但细节容易忽略。