XmlSerializer 中字段需标记 [XmlAttribute] 才序列化为 XML 属性，仅 public 字段或自动属性有效，且不能为复杂类型；若同时存在 [XmlElement] 等特性会覆盖 [XmlAttribute]；string 为 null 时不输出该属性，空字符串则输出 AttrName=""。
XmlSerializer 怎么让字段序列化成 XML 属性而不是元素
默认情况下，XmlSerializer 会把 public 字段或属性序列化为 XML 元素（即 `[XmlAttribute] 才是属性。
常见错误是只加 [XmlElement] 或干脆不加，结果死活出不来属性；或者误以为 private 字段加特性也生效（实际无效，XmlSerializer 只处理 public 成员）。
- 必须作用于 public 字段或 public 自动属性
- 不能用于索引器、只读属性（get-only）、或没有 public set 的属性（除非用
[XmlIgnore]+ 手动控制，但那就绕开自动序列化了） - 若字段类型是复杂对象，
[XmlAttribute]会报错——XML 属性值只能是字符串、数字、枚举等可直接字符串化的简单类型
string 类型字段加 [XmlAttribute] 后仍生成元素？检查是否被其他特性覆盖
有时明明加了 [XmlAttribute]，生成的还是元素。大概率是同时存在 [XmlElement]、[XmlText] 或 [XmlAnyElement] ——这些特性互斥，且 [XmlElement] 优先级高于 [XmlAttribute]，一旦共存，后者会被忽略。
另一个隐蔽原因是：类上加了 [XmlRoot] 并设置了 ElementName，但这不影响字段级行为；真正干扰的是字段/属性自身所带的多个序列化特性。
- 一个成员上只保留一个序列化特性：要么
[XmlAttribute]，要么[XmlElement]，不要混用 - 用反编译或调试时检查
typeof(MyClass).GetFields()的自定义特性，确认[XmlAttribute]确实存在且没被遮蔽 - 如果用了部分类（partial class）或源生成器，注意特性可能在另一处被意外注入
XmlAttribute 序列化 null string 会怎样？空字符串和 null 的区别
XmlAttribute 对应的字段如果是 string，值为 null 时，该属性**不会出现在 XML 中**；值为 ""（空字符串）时，则会输出 AttrName=""。
这和 [XmlElement] 不同——后者对 null 默认输出 <name xsi:nil="true"></name>（需启用 XmlSerializerNamespaces 和 xsi 命名空间）。所以如果你依赖属性“存在即有效”，就得小心 null 被静默丢弃。
- 若业务要求属性必须出现（哪怕为空），就别用
null，初始化为"" - 若需区分“未设置”和“设为空”，
XmlAttribute本身不支持，得换方案（比如加个bool IsNameSpecified { get; set; }配合[XmlIgnore]+ 手动逻辑） -
[XmlAttribute(DataType = "date")]这类附加类型提示，只影响 XSD 生成，不影响运行时序列化行为
.NET 6+ 中 XmlSerializer 仍可用，但要注意跨平台兼容性细节
XmlSerializer 在 .NET Core/.NET 5+ 里依然工作，但默认不包含在最小 API 模板中，需确认项目已引用 System.Xml.XmlSerializer 包（SDK 风格项目通常自带，但某些裁剪场景可能被移除）。
更关键的是：Windows 上默认使用 UTF-16 编码写入 XML 声明（<?xml version="1.0" encoding="utf-16"?>），而 Linux/macOS 下 XmlSerializer 输出可能是 UTF-8 ——如果下游系统严格校验编码声明与实际字节，这里容易出问题。
- 显式指定编码：用
XmlWriter.Create(stream, new XmlWriterSettings { Encoding = Encoding.UTF8 })包一层再传给Serialize() - 避免依赖
XmlSerializer自动生成的 XML 声明；如需稳定格式，用XmlWriter手动控制更可靠 - 若项目已转向
System.Text.Json，别为了 XML 属性特地切回XmlSerializer——JSON 没有“属性/元素”概念，这种设计意图本身就需要重新评估
最常被忽略的一点：XmlAttribute 的名称默认取字段名，但如果你改了字段名又没更新对应契约（比如旧 XML 还在被第三方解析），就可能造成静默失败——序列化正常，反序列化时因找不到匹配属性而跳过，还不报错。
