17370845950

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 会自动帮你格式化输出。关键是信任它的默认行为，而不是试图手动控制布局。