XmlWriter.Save()输出异常的主因是默认配置过于严格：需显式设置OmitXmlDeclaration=false、Indent=true等参数，避免重复WriteStartDocument，并注意CloseOutput和编码一致性。
Save 方法写入 XmlWriter 时内容为空或格式错乱
直接调用 XDocument.Save(XmlWriter) 却发现输出为空、缩进丢失、甚至 XML 声明都没写出来，根本原因是 XmlWriter 默认配置太“严格”——它不自动写声明、不默认缩进、甚至可能因 WriteStartDocument() 被提前调用而拒绝重复写入。
实操建议：
- 务必用
XmlWriter.Create()配置好XmlWriterSettings，不能传裸的TextWriter或默认实例 - 设置
OmitXmlDeclaration = false（默认是true），否则连<?xml version="1.0" encoding="utf-8"?>都不会出现 - 需要缩进必须显式设
Indent = true，且推荐搭配IndentChars = " "控制空格数 - 避免手动调用
WriteStartDocument()——XDocument.Save()内部会自己处理，重复调用会导致InvalidOperationException: Token StartDocument has already been written
示例正确写法：
var settings = new XmlWriterSettings
{
OmitXmlDeclaration = false,
Indent = true,
IndentChars = " ",
Encoding = Encoding.UTF8
};
using var writer = XmlWriter.Create(stream, settings);
doc.Save(writer); // 这里不加任何前置 write 操作
XmlWriter 的 CloseOutput 和流生命周期问题
保存后发现流被意外关闭、后续无法读取，或者抛出 ObjectDisposedException，大概率是 XmlWriter 把底层 Stream 给关了——这是它的默认行为，不是 bug。
实操建议：
- 如果要复用同一个
Stream（比如写完 XML 再追加二进制数据），必须设CloseOutput = false - 设了
CloseOutput = false后，XmlWriter不再负责释放流，你得自己确保Stream在合适时机被Dispose() - 若用
MemoryStream做中间缓存，别依赖ToArray()前是否已Close()；CloseOutput = false下，ToArray()仍可用，但记得Position = 0才能读
编码不一致导致中文乱码或 XmlException
保存后文件打开是乱码，或反序列化时报 XmlException: Data at the root level is invalid，常见于 XmlWriterSettings.Encoding 和实际写入目标（如 FileStream、StreamWriter）编码不匹配。
实操建议：
-
XmlWriterSettings.Encoding必须和底层流/写入器的实际编码一致；例如用UTF8设置却往ASCIIEncoding的StreamWriter里写，必然出错 - 写入文件时，优先用
FileStream+XmlWriterSettings.Encoding组合，而不是套一层StreamWriter——后者容易绕过编码控制 - 若目标是网络响应（如 ASP.NET Core
HttpResponse.Body），确认Content-Type头包含; charset=utf-8，否则浏览器可能按 ISO-8859-1 解析
大文档下 XDocument.Save() 性能明显下降
XDocument 是内存树模型，Save() 本质是遍历整棵树再逐节点写入。当节点超 10 万级或含大量文本内容时，GC 压力和字符串拼接开销会突增，比手写 XmlWriter.WriteElementString() 慢数倍。
实操建议：
- 纯生成场景（无需查询/修改 XML 结构），直接用
XmlWriter流式写入，跳过XDocument构建环节 - 若必须用
XDocument（比如要 XPath 查询后再保存），保存前可调用doc.Descendants().Where(x => x.Nodes().Count() == 0).Remove()清理空白文本节点，减少遍历量 - 不要在循环里反复
new XDocument()+Save()；改用单个XmlWriter复用，或批量构建后一次性保存
真正麻烦的从来不是怎么写那行 doc.Save(writer)，而是你没意识到 XmlWriter 的每个开关都在悄悄改写输出行为——漏掉一个 Indent 或多写一个 WriteStartDocument，就足以让下游系统拒收整个文件。
