XDocument默认会自动格式化输出,只需正常构建元素层级并调用Save(filename)即可生成带缩进和换行的XML,无需手动处理;避免使用SaveOptions.DisableFormatting或LoadOptions.PreserveWhitespace,否则会破坏格式化效果。

使用 C# 的 XDocument 保存 XML 时,想要实现格式化输出(自动添加换行和缩进),无需手动处理换行和空格,只需要在保存时启用格式化选项即可。
启用格式化保存
XDocument.Save() 方法默认会保留原始结构,但如果通过指定 SaveOptions 参数为 None 或未设置,可能不会自动格式化。要让输出自动美化(带缩进和换行),应使用 SaveOptions.None 并确保文档结构“干净”——但更关键的是:在创建或加载后不要禁用格式化。
实际上,XDocument 在调用 Save 时默认就会格式化内容,前提是:
- 没有手动设置
Formatting="None" - 元素是正常添加的,不是通过原始字符串插入
正确示例:自动格式化输出
以下代码会自动生成带缩进和换行的 XML 文件:
XDocument doc = new XDocument(
new XElement("Root",
new XElement("Child1", "Value1"),
new XElement("Child2",
new XElement("SubChild", "Nested Value")
)
)
);
doc.Save("output.xml"); // 默认就是格式化输出
生成的 output.xml 内容如下:
Value1 Nested Value
可以看到,系统已自动添加了缩进和换行。
避免破坏格式化的常见错误
以下情况会导致无法格式化:
- 使用
new XText()手动插入换行或空格文本节点 - 从字符串加载时包含多余空白且设置了
LoadOptions.PreserveWhitespace - 保存时使用了
SaveOptions.DisableFormatting
例如,这样会禁用格式化:
doc.Save("output.xml", SaveOptions.DisableFormatting);
这将导致所有内容挤在一行。
推荐做法
- 正常构建 XElement 层级结构,不要手动加
\n或空格 - 避免使用
PreserveWhitespace加载选项,除非需要保留原始空白 - 保存时使用默认的
Save(filename)或显式使用SaveOptions.None(这是默认行为)
基本上就这些。只要不主动干扰,XDocument 会自动帮你格式化输出。关键是信任它的默认行为,而不是试图手动控制布局。










