本文深入解析 saxon-he 11.x 及 12.x 版本中 xml 输出缩进行为的变化根源，揭示其并非由 ubuntu、debian 或 rhel 等操作系统差异导致，而是源于 saxon 内部 emitter 实现升级引发的统一行为演进，并提供可验证的定位方法与临时修复方案。
本文深入解析 saxon-he 11.x 及 12.x 版本中 xml 输出缩进行为的变化根源，揭示其并非由 ubuntu、debian 或 rhel 等操作系统差异导致，而是源于 saxon 内部 emitter 实现升级引发的统一行为演进，并提供可验证的定位方法与临时修复方案。
在使用 Saxon-HE 进行 XSLT 转换时，开发者可能观察到：同一套 Java 代码、XSLT 模板和输入 XML，在 Ubuntu 22.04、Debian 10 和 RHEL 系统上，生成的 XML 属性缩进存在细微差异——例如第二、三行属性前多出一个空格。这一现象曾被误认为是“OS 相关 bug”，但实则为 Saxon 版本演进中的设计变更，且自 Saxon 12.2 起已在所有平台（包括 macOS、Windows）达成行为一致。
根本原因：Emitter 架构升级与空格计数逻辑变更
关键转折点发生在 Saxon 10.x。此前（如 Saxon 9.x），XMLEmitter 逐个处理元素属性，缩进决策基于单个属性写入时的实时行宽判断；而从 10.x 开始，Saxon 改为在 startElement 事件中批量传递全部属性，从而能预先计算总长度并统一决定是否换行缩进。
这一优化带来了更稳定的格式化效果，但也改变了缩进基准值的计算方式。核心逻辑位于 XMLEmitter.java 中：
int indent = (level - 1) * getIndentation() + 3; emitter.setIndentForNextAttribute(indent);
此处的 + 3 是问题源头：它原本模拟旧版“写入换行符 + 前导空格”的复合操作（即 \n + 两个空格 → 视觉上等效于 3 字符偏移），但在新式 UTF-8 writer 中，setIndentForNextAttribute() 直接写入纯空格字符（不含换行符）。因此，+3 实际导致每行属性比预期多出一个空格。
✅ 验证结论：该行为与操作系统无关。所谓“Ubuntu 多空格、Debian/RHEL 少空格”实为测试环境混用了不同 Saxon 版本（如 Ubuntu 测试用 11.2，Debian 用 9.9），或 JVM/Writer 实现细节引发的偶然差异。Saxon 12.2 已彻底统一逻辑，所有平台均稳定输出 +3 缩进。
快速复现与验证方法
使用以下最小化示例即可复现：
XSLT（indent.xsl）：
<?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:output method="xml" omit-xml-declaration="no" indent="yes"/> <xsl:template match="/"><xsl:copy-of select="."/></xsl:template> </xsl:stylesheet>
XML 输入（input.xml）：
<ex:root xmlns:ex="example"> <ex:Property name="property-main-1" value="A pretty long value for an attribute. But we need to test the indentation as well"/> </ex:root>
执行命令（确保使用相同 Saxon JAR）：
java -jar saxon-he-11.2.jar -s:input.xml -xsl:indent.xsl -o:out.xml
对比 out.xml 中 <ex:Property> 标签的属性缩进即可确认行为一致性。
临时解决方案与生产建议
短期规避：若需严格兼容旧缩进（如校验 XML 签名或 Diff 比对），可修改 Saxon 源码将 +3 改为 +2（需重新编译），或使用 indent="no" 后通过外部工具（如 xmllint --format）标准化。
长期实践：
✅ 不要依赖缩进作为语义依据 —— XML 规范明确声明空白字符（含缩进）在大多数上下文中无语义；
✅ 锁定 Saxon 版本 —— 在构建脚本中显式声明 saxon-he:12.2（Maven）或下载固定版本 JAR，避免 CI/CD 环境因缓存导致版本漂移；
✅ 关注官方进展 —— 该问题已提交至 Saxon 官方追踪系统（Issue #6063），后续版本可能提供配置项控制缩进偏移量。
归根结底，这不是 Linux 发行版的“爱恨情仇”，而是现代 XML 处理器在性能与兼容性权衡中的一次迭代印记。理解其技术动因，方能从容应对跨平台交付中的格式一致性挑战。
