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 的子元素之外
基本上就这些。只要处理器支持、路径合法、内容结构完整，生成多个文件并不复杂，但细节容易忽略。
