PHP XMLWriter 缩进为什么会影响混合文本内容

XMLWriter 的自动缩进会参与生成 XML 字节；在同时包含子元素和文字的混合内容中，新增的换行或空格可能被接收方当成文本。不能把 XML 中所有标签间空白都视为可忽略排版。对必须精确保留正文的导出任务，稳妥做法是在写入内容前关闭缩进，并避免交付前再次美化正文。

官方文档：https://www.php.net/manual/en/xmlwriter.setindent.php

把排版空白与业务文本分开

假设通知正文由一个 strong 元素和紧随其后的文字组成：强调标签之后立即接“后继续处理”。如果接收系统提取整段文本，它关心的不只是标签是否配对，还关心相邻文本之间有没有多出换行。另一方面，正文中有意保留的两个空格也属于数据，不能顺手压缩掉。

混合内容指一个元素中既有子元素，又有字符数据。与只按字段读取子元素的配置文件相比，这类正文对空白更敏感。不过，开启缩进不代表每一种写入顺序必然破坏文本：写入器会维护内部状态，实际行为还与内容及调用顺序有关。出现异常时应观察原始输出，不能仅凭 setIndent(true) 一行就断言具体多出了几个字符。

在写入混合内容前关闭自动缩进

下面给出一个内存导出函数，在打开缓冲区后立即调用 setIndent(false)。示例中的标签文本由 text() 写入，正文空格也由显式文本决定；不靠缩进功能生成业务分隔符。环境需要提供 XMLWriter 扩展，代码供目标 PHP 环境使用，本文没有执行或展示运行日志。

openMemory(), '打开内存缓冲区');
    // 在任何正文节点写入之前关闭缩进，避免向正文区域插入排版字符。
    mustWrite($writer->setIndent(false), '关闭缩进');
    mustWrite($writer->startDocument('1.0', 'UTF-8'), '文档声明');
    mustWrite($writer->startElement('notice'), '根元素');

    // notice 同时包含强调元素和尾随文字，属于混合内容。
    mustWrite($writer->startElement('strong'), '强调元素');
    mustWrite($writer->text($label), '标签文本');
    mustWrite($writer->endElement(), '结束强调元素');
    mustWrite($writer->text('后继续处理，保留  两个空格。'), '正文文本');

    mustWrite($writer->endElement(), '结束根元素');
    mustWrite($writer->endDocument(), '结束文档');
    // 完成后一次取出结果；此处不对 XML 正文做 trim 或全局替换。
    return $writer->outputMemory();
}

echo buildNotice('确认 & 归档');

函数的预期是：strong 中保留标签文字及其转义表示，strong 后直接接尾随文本，句子中显式写入的两个空格仍在。文档声明后的换行与根元素内部字符数据应分开判断，不能因为整个文件含有换行就认定正文被改写。

这里选择整份正式导出关闭缩进，而不是先输出一部分内容再临时切换开关。后切换不能撤销已经写入缓冲区的字符；对于正文关键区域，提前确定序列化策略更清楚。

沿文本节点检查多出来的空白

排查时保留一份原始 XML，并同时记录接收方实际取出的文本。分别判断异常来自生成器、后续美化器，还是接收方的展示规则。例如浏览器会折叠某些显示空白，它看到的样子不一定等于文件中的字符。

不要对整个 XML 用正则删除所有标签之间的空白，也不要对每个文本节点统一 trim。这样的处理可能刚好删掉新增缩进，也可能删掉本来需要的词间分隔。xml:space 所表达的保留意图也不能当成“写入器一定不会新增空白”的通用开关。

把导出正文与阅读副本分开管理

自动导出时可把用途分成两份：正式 XML 交给接收方，阅读副本由排版工具另行处理。正式 XML 不被阅读副本覆盖；失败时保留生成阶段与输入记录，避免把半成品继续发送。对外约定若要求字节一致，还需明确编码、换行和后续处理步骤，而不只是关闭缩进。

项目可以围绕几个代表性样例检查导出约定：开头就是子元素、文字包围子元素、相邻内联元素以及显式双空格。这里的目的应是核对真实正文语义，而不是只比较 XML 是否更好看。若改变 PHP 或底层库版本，也要保留这些样例来观察差异。

setIndentString 改成空字符串就足够吗？

不要把缩进字符的配置等同于彻底关闭自动排版。正文要求不插入格式空白时，直接明确 setIndent(false)，并检查后续是否还有美化步骤。

全部改成 CDATA 能解决吗？

CDATA 是文本表示方式，不会自动修正整个混合内容模型，也不能容纳任意子元素结构。先确定内容与节点的边界，再选择表示方式。

机器读取的 XML 都应该禁止缩进吗？

不必一概而论。是否允许格式空白应由内容模型和接收约定决定；含正文的混合内容尤其需要精确保留。

参考文本写入接口：https://www.php.net/manual/en/xmlwriter.text.php；XML 空白与混合内容规则：https://www.w3.org/TR/xml/。先定义正文语义，再决定排版策略，才能避免让美化操作改变实际内容。