如何格式化和美化 XML 文本

什么时候使用 XML 格式化工具

这款工具用于把 XML 文本整理成更易阅读的缩进格式，也可以压缩成更紧凑的单行风格。它适合检查层级、阅读配置内容，或在需要减少标签之间空白时处理 XML。输入必须是 XML 文本；空文本或只含空白的内容会成功返回空输出。

格式化 XML 的操作步骤

1. 准备 XML 文本，并将其填入输入区域。输入应为字符串；如果内容包含非空白字符，长度还应不超过 1,000,000 个 UTF-8 字节。
2. 选择输出模式。美化模式会生成带缩进的可读文本，也是默认模式；压缩模式使用 minify，适合去除注释、标签之间的空白，以及开头和结尾的空白。
3. 设置缩进宽度。默认值为 2 个空格；非空输入可使用 0 到 8 的整数。小于 0、大于 8 或无法转换为整数的值会回退为 2。
4. 执行格式化并查看结果。美化模式会先解析 XML；非空输入使用压缩模式时也会先验证 XML。若 XML 结构不正确，处理会失败，而不会生成正常格式化结果。
5. 若结果失败，检查输入是否为字符串、标签是否正确闭合，以及注释和属性所在位置是否符合 XML 语法，然后重新提交。

如何理解处理结果

美化结果应呈现分层、带缩进的 XML 文本，缩进宽度取决于有效设置。压缩结果会移除 XML 注释、标签之间的空白，并清除首尾空白，因此不适合需要保留这些内容的场景。压缩并不意味着可以跳过 XML 校验：含有非空白字符的输入仍需通过解析或验证。空白输入则在前置处理阶段直接返回空输出。

使用示例

你需要阅读一段层级较深的 XML 配置，并在传输前去掉标签之间的空白。

将包含嵌套元素的 XML 字符串提交，选择美化模式并把缩进设为 4；随后改选压缩模式再次处理，并比较两种结果的空白变化。

成功时，美化结果为带层级缩进的 XML 文本；若选择压缩，结果为移除注释、标签间空白及首尾空白后的 XML 文本。

使用限制

• 压缩模式不会保留 XML 注释或标签之间的空白；无效 XML 可能处理失败，含有非空白字符的输入超过 1,000,000 个 UTF-8 字节时会被拒绝。

常见错误

• 如果 XML 标签未闭合、嵌套关系错误或输入并非有效 XML，处理可能失败。请先修正 XML 结构，再选择美化或压缩模式提交。

常见问题

空白输入会发生什么？

输入为空或只含空白时，会成功返回空输出；含有非空白字符的输入则必须是字符串，并且需要通过相应的 XML 处理。

可以自定义 XML 缩进吗？

可以。美化模式默认使用 2 个空格，也可以设置缩进宽度；非空输入中，低于 0、高于 8 或无法转换为整数的值会回退为 2。

压缩 XML 时会保留注释和空白吗？

如果 XML 含有非空白字符，压缩模式仍会先验证 XML；结构不正确时会失败。压缩还会移除注释、标签之间的空白以及首尾空白。