XmlArray不起作用的根本原因是未配对使用XmlArrayItem——必须同时标注XmlArray("Items")和XmlArrayItem("Item")或XmlArrayItem(typeof(string))，否则XmlSerializer退回到默认命名。
XmlArray 为什么不起作用：序列化后还是默认名称
常见现象是加了 [XmlArray("Items")]，但生成的 XML 里标签名仍是 ArrayOfString 或 SomeList。根本原因是没配对使用 [XmlArrayItem] —— XmlSerializer 要求数组/集合字段上同时声明容器名和子项名，否则它会退回到默认命名逻辑。
实操建议：
- 必须同时标注
[XmlArray("Items")]和[XmlArrayItem("Item")]，哪怕你只想要容器改名、子项用默认名，也得显式写[XmlArrayItem(typeof(string))]或指定类型 - 如果字段是
List<string>，[XmlArrayItem]的type参数不能省；若为自定义类，可省略type，但必须确保该类有无参构造函数 - 别在属性上用
[XmlElement]和[XmlArray]混用——它们互斥，后者优先级更高，前者会被忽略
XmlArray + XmlArrayItem 的参数怎么选：name 还是 elementName
[XmlArray] 的 ElementName 属性不存在，只有 Name；而 [XmlArrayItem] 有两个关键参数：ElementName（控制每个子元素的标签名）和 Type（指定实际序列化的类型）。混淆这两者是常见错误源头。
实操建议：
-
[XmlArray("Products")]→ 控制外层容器标签名，如<Products>...</Products> -
[XmlArrayItem("Product")]→ 控制每个子项标签名，如<Product>...</Product>；若不写，默认用类名或泛型参数名 - 如果集合里混了多种类型（比如
List<object>），必须用[XmlArrayItem("Dog", typeof(Dog))]+ 多个同名特性，否则反序列化失败
序列化 List<T> 时出现“无法序列化类型”错误
典型错误信息：System.InvalidOperationException: There was an error reflecting type 'MyClass'，内嵌提示 “Cannot serialize member ... because it is an interface or abstract class”。这通常发生在字段类型是 IList<T>、IEnumerable<T> 或接口时。
实操建议：
- 把字段类型改为具体实现类，如
List<Product>或Product[]；XmlSerializer不支持接口或抽象类型直接序列化 - 如果必须用接口，可在类上加
[XmlInclude(typeof(Product))]，并确保集合字段是object或基类类型，再配合多个[XmlArrayItem] - 注意：
XmlSerializer不处理readonly字段、private set属性，只序列化 public 字段或有 public getter/setter 的属性
生成的 XML 多了一层 wrapper 元素，怎么去掉
比如你写了 [XmlArray("Items")]，结果得到：<Items><Items><Item>...</Item></Items></Items>——这是因为在类中用了属性包装集合，又忘了关掉默认行为。
实操建议：
- 确认字段/属性上没有多余的
[XmlElement]或[XmlRoot]干扰；[XmlArray]必须直接修饰集合成员本身 - 如果用的是属性（非字段），且 getter/setter 有逻辑，确保 backing field 没被意外序列化；必要时加
[XmlIgnore]排除干扰项 - 不要试图用
[XmlText]或[XmlAttribute]去“修复”数组结构——它们和数组序列化机制不兼容
最易被忽略的一点：XmlSerializer 对泛型约束很死，List<T> 可以，ImmutableArray<T> 或 ReadOnlyCollection<T> 默认不行，得靠 XmlArrayItem 显式绑定类型，还得保证运行时能实例化。
