XmlElement 的 Name 参数不生效，主要因上级属性（如 XmlRoot、XmlArray）覆盖、public 成员混用多种 XML 属性、集合标签名控制逻辑混淆、IsNullable 误解、同名元素冲突、大小写严格匹配及隐性耦合所致。
XmlElement 的 Name 参数不生效？检查是否用了 [XmlRoot] 或其他覆盖属性
直接写 [XmlElement(Name = "user_id")] 却发现序列化出来还是字段名 UserId，大概率是类上加了 [XmlRoot("user")] 或者整个类型被嵌套在另一个 [XmlArray] 里——这些上级声明会压制子元素的 Name 设置。更隐蔽的是：如果字段是 public，而你又同时加了 [XmlElement] 和 [XmlAttribute]，XmlSerializer 会静默忽略 [XmlElement]。
- 只对
public字段/属性生效；private或internal成员加了也白加 - 若字段类型是集合（如
List<string></string>），[XmlElement]控制的是每个项的外层标签名，不是整个集合容器名——容器名得靠[XmlArray]和[XmlArrayItem] - 别在同一个成员上混用
[XmlElement]、[XmlAttribute]、[XmlText]，XmlSerializer只认一个，且不报错
想让 null 值字段不输出？IsNullable = false 不管用，得配 [XmlElement(IsNullable = true)] + 空值逻辑
IsNullable = false 的作用常被误解：它只影响 XSD 生成时的 nillable="false"，对序列化行为完全没影响。真正控制“null 是否写入 XML”的，是字段本身的可空性 + 序列化时的值。比如 string 类型字段为 null，默认就不输出；但 int? 为 null 时，默认会输出 <age xsi:nil="true"></age>。
- 要彻底跳过 null 字段，把
[XmlElement(IsNullable = true)]改成[XmlElement(IsNullable = false)]没用；正确做法是加一个对应的方法：public bool ShouldSerializeAge() => Age.HasValue; - 方法名必须严格是
ShouldSerialize{PropertyName}()，返回bool，且不能带参数 - 这个机制对所有可空值类型、引用类型都有效，但不会影响反序列化——反序列化时仍能接受缺失的元素
命名冲突：多个字段想映射到同名 XML 元素？XmlSerializer 不支持，得换思路
XmlSerializer 要求同一层级下所有 [XmlElement] 的 Name 必须唯一，否则运行时报 InvalidOperationException：“Types 'A' and 'B' both use the XML element name 'item'”。这不是配置问题，是设计限制——它无法区分同名但类型不同的元素。
- 不能靠
[XmlElement("item", Type = typeof(A))]绕过，Type参数只用于多态序列化，不解决同名冲突 - 真要共用标签名，只能把它们收进一个容器类，用
[XmlArray("items")]+[XmlArrayItem("item", typeof(A))]和[XmlArrayItem("item", typeof(B))]组合 - 或者放弃
XmlSerializer，改用XmlDocument或XDocument手动构造，灵活性高但失去声明式映射
大小写敏感：XML 元素名区分大小写，但 .NET 属性名习惯 PascalCase，别硬套
写 [XmlElement("UserID")] 是合法的，但容易和 C# 命名规范冲突，且一旦拼错（比如写成 "userid"），反序列化时字段就收不到值——XmlSerializer 完全按字面匹配，不自动做大小写转换或驼峰推导。
- 建议统一用小写+下划线风格（如
"user_id"）或 kebab-case（如"user-id"），和主流 API 习惯对齐 - 避免用
"User_ID"这种混合风格，XML 解析器虽能接受，但某些老系统或验证工具会报格式警告 - 如果对接已有 XML Schema（XSD），优先按 XSD 里的
element name去写Name，而不是反向推导
最麻烦的不是怎么写对，而是改完一处 Name 后忘了同步更新文档、测试用例，或者遗留了旧字段的 ShouldSerializeXxx 方法——这种隐性耦合，上线后才暴露。
