本文介绍如何在 XSLT 转换 HTML 时防止 内容因缩进或换行符被错误保留，通过 suppress-indentation 属性精准控制空白处理，确保多行 元素各自生成独立、干净的 ... 结构。
本文介绍如何在 xslt 转换 html 时防止 `` 内容因缩进或换行符被错误保留，通过 `suppress-indentation` 属性精准控制空白处理，确保多行 `
在使用 XSLT（尤其是配合 Apache FOP 或现代处理器如 Saxon）生成 HTML 时，一个常见却易被忽视的问题是：源 XML 中逻辑上连续的文本内容，在 XSLT 模板中因格式缩进或换行而被意外引入不可见的空白字符（如换行符 \n 和空格），最终污染 的文本内容。
例如，原始 XML 包含两个独立
<text>This is a longer text where every line will be written into a span html element and somehow there will</text> <text>be added a line break where there is none</text>
若采用如下看似简洁的模板：
<xsl:template match="text">
<div>
<span>
<xsl:value-of select="."/>
</span>
</div>
</xsl:template>XSLT 处理器（尤其默认启用缩进输出时）会将模板中的换行与缩进视为“有意义的空白”，并将其保留在 内部文本中——导致第一段末尾出现换行符和多余空格，破坏 white-space: pre 的预期对齐效果，使渲染错位。
✅ 根本解法：禁用特定元素的自动缩进输出
XSLT 3.0 引入了
<xsl:stylesheet version="3.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 关键配置：禁止 span 元素被缩进 -->
<xsl:output method="html" suppress-indentation="span"/>
<xsl:template match="text">
<div>
<span>
<xsl:value-of select="."/>
</span>
</div>
</xsl:template>
</xsl:stylesheet>✅ 此方案要求使用支持 XSLT 3.0 的处理器，如 Saxon 9.8+（HE/PE/EE）。Apache FOP 2.3 自带的是较旧的 Xalan（仅支持 XSLT 1.0），不支持 suppress-indentation；若必须使用 FOP，需升级至集成 Saxon 的新版 FOP（如 FOP 2.9+ 配 Saxon-HE），或改用预处理方式（如
+ 手动 normalize-space() 控制）。
? 补充建议与注意事项：
- 若无法升级到 XSLT 3.0，退而求其次可结合
+ normalize-space() 显式清理： <xsl:template match="text"> <div> <span> <xsl:value-of select="normalize-space(.)"/> </span> </div> </xsl:template>但注意：normalize-space() 会将内部多个空格压缩为单个，并删除首尾空白——若原文本需保留精确空格（如等宽排版），此法不适用。
- CSS 层面，span { white-space: pre; } 确保换行符被渲染，因此必须确保 XSLT 输出中无非预期换行符；更安全的替代是 white-space: nowrap（配合 display: inline-block）+ 服务端严格控制文本纯净度。
- 始终验证输出 HTML 的实际源码（而非浏览器渲染结果），以确认 内容是否真正“无换行、无缩进空格”。
通过合理配置 suppress-indentation，你不仅能获得语义清晰、结构可控的 HTML 输出，更能从根本上规避因 XSLT 格式化策略引发的样式异常——让每一行
