xmlwriter.create 默认不写 xml 声明因 xmlwritersettings.omitxmldeclaration 默认为 true，是为拼接片段等场景设计；独立文件需显式设为 false，并统一使用 new utf8encoding(false) 避免 bom 冲突。
XmlWriter.Create 为什么默认不写 XML 声明？
因为 XmlWriterSettings.OmitXmlDeclaration 默认是 true，不是疏忽，是设计如此——很多场景（比如拼接 XML 片段、嵌入到已有文档）确实不需要声明。但如果你生成的是独立文件，漏掉它会导致解析器报错或编码识别错误。
实操建议：
- 显式设置
settings.OmitXmlDeclaration = false，这是最安全的起点 - 如果要指定编码（比如 UTF-8），必须同时设
settings.Encoding = new UTF8Encoding(false)（false表示不写 BOM，避免某些老系统解析异常） - 注意：一旦设了
Encoding，XML 声明里的encoding属性会自动同步，别手动在字符串里硬写
用 StreamWriter 包裹 FileStream 时，Encoding 怎么对齐？
常见错误是：FileStream 用 UTF8Encoding(true)，XmlWriterSettings.Encoding 却用 UTF8Encoding(false)，结果 XML 声明写 encoding="UTF-8"，但文件开头多了 BOM，某些 XML 解析器（如 .NET 的 XDocument.Load）会直接抛 XmlException：“数据在根级别上无效”。
实操建议：
- 统一用
new UTF8Encoding(false)—— 不带 BOM 是 XML 标准推荐做法 - 别用
StreamWriter自己构造流再传给XmlWriter.Create；直接传FileStream+XmlWriterSettings，让XmlWriter自己处理编码 - 如果必须用
StreamWriter（比如要加日志或中间处理），确保它的Encoding和XmlWriterSettings.Encoding完全一致
Indent 后属性换行错乱？
XmlWriterSettings.Indent = true 看似简单，但默认只缩进元素，不处理属性。结果就是：<root id="1" name="test"></root> 这种长行依然存在，可读性没提升，还可能触发某些格式校验工具告警。
实操建议：
- 加
settings.IndentChars = " "（两个空格，别用 tab，部分解析器对 tab 敏感） - 属性不换行是标准行为，无法靠
XmlWriter内置设置解决；如需强制每属性一行，得自己实现XmlWriter子类，或改用XDocument+ToString()（但会失去流式写入优势） - 如果只是调试看输出，临时用
XDocument.Parse(writer.ToString())再格式化更省事，别强求XmlWriter全能
异步写 XML 文件为什么不能直接用 XmlWriter.Create(Stream)？
XmlWriter.Create 返回的实例**不支持异步方法**，它的 WriteStartElementAsync 等方法只是同步方法的包装，实际仍是阻塞调用。真用在 ASP.NET Core 高并发场景下，会吃光线程池，出现请求堆积。
实操建议：
- 不要被方法名里的
Async迷惑——查 MSDN 文档会发现它们标注为[Obsolete]，且备注明确写“此方法已过时，不应使用” - 真正异步写 XML，要么用
XmlSerializer序列化对象后调stream.WriteAsync，要么用System.Text.Json（如果结构允许 JSON 替代） - 若必须用
XmlWriter流式写且要异步，只能把整个写入逻辑包进Task.Run，但这是权衡：换来了响应性，增加了线程开销
关键点其实就一个：XmlWriter 是为吞吐和确定性设计的，不是为 async/await 场景优化的。选它，就得接受同步模型；想异步，得换思路。
