XmlEnum 的名称不生效是因为未传字符串参数，必须用 [XmlEnum("xxx")] 而非无参 [XmlEnum]；它仅作用于枚举成员，且匹配严格区分大小写、自动去除首尾空格。
XmlEnum 的名称不生效？检查是否漏了 XmlEnumAttribute 构造函数参数
默认情况下，XmlSerializer 会把枚举成员名原样序列化成 XML 标签值。想改名字，必须显式加 [XmlEnum("xxx")]，且括号里要传字符串——只写 [XmlEnum]（无参）完全没用，这是最常踩的坑。
常见错误现象：XmlSerializer 输出的 XML 里还是大驼峰名（比如 MyValue），而不是你期望的 my-value。
- 必须用
[XmlEnum("my-value")]，不能只写[XmlEnum] - 属性只能加在枚举成员上，不能加在枚举类型上
- 如果同时用了
[XmlRoot]或[XmlElement]，它们不影响枚举值本身的序列化名
public enum Status
{
[XmlEnum("pending")]
Pending,
[XmlEnum("done")]
Done
}
序列化时值为空字符串或 null？确认枚举字段是否可空
XmlSerializer 不支持直接序列化 Nullable<t></t> 枚举的 null 值——它会跳过整个字段，或者抛 InvalidOperationException，具体取决于上下文和是否标记了 [XmlIgnore]。
使用场景：API 返回状态码枚举，但某些情况下字段可能未设置。
- 若字段声明为
Status?，且值为null，默认序列化后该 XML 元素将消失（不是输出空字符串） - 想强制输出空值，得配合
[XmlElement(IsNullable = true)]，但注意：这会让 XML 出现xsi:nil="true"，不是空字符串 - 如果真需要空字符串表示“未设置”，建议改用字符串字段 + 手动映射，别硬扛可空枚举
反序列化失败：XML 值匹配不到枚举成员？大小写和空白是关键
XmlSerializer 对 XmlEnum 值的匹配是**严格大小写敏感**的，且两端空白会被 trim，但中间空格不会自动处理。
错误现象：XmlSerializer.Deserialize 报错 There is an error in XML document，内层异常提到 “xxx is not a valid value for Status”。
- XML 中写的是
<status>PENDING</status>，但代码里是[XmlEnum("pending")]→ 匹配失败 - XML 中是
<status> pending </status>（带空格）→ 自动 trim 后变成"pending"，能匹配 - XML 中是
<status>in progress</status>，而代码写的是[XmlEnum("in-progress")]→ 不匹配，连短横都不通融
.NET Framework 和 .NET 5+ 行为一致吗？基本一致，但别信默认构造函数
从 .NET Framework 2.0 到 .NET 7，XmlEnumAttribute 的行为没变过。真正容易混淆的是文档里写的“默认构造函数”，实际根本不存在——XmlEnumAttribute() 这个无参构造函数在源码里被标记为 internal，公开 API 只有 XmlEnumAttribute(string name) 一个入口。
性能影响几乎为零；兼容性不是问题，但开发时如果依赖 IntelliSense 提示以为能写无参形式，就会卡住。
- VS 或 Rider 输入
[XmlEnum]后按 Tab，可能补全成无参形式——删掉，手动补上引号和字符串 - 不要试图用反射绕过这个限制，
XmlSerializer内部只读取Name属性，没设就是null，匹配时直接 fallback 到枚举成员名 - 如果项目混用
System.Text.Json，注意它不认XmlEnumAttribute，得另配JsonStringEnumConverter
