C#中Dictionary<K,V>不能直接用XmlSerializer序列化，需转为可序列化结构；推荐用带XmlElement的SerializableDictionary包装类，或用DataContractSerializer（支持泛型但XML冗余），也可转List<KeyValuePair>轻量处理。
C# 中 Dictionary<K,V> 不能直接用 XmlSerializer 序列化，因为 XmlSerializer 要求类型具有公共无参构造函数、公共读写属性，且不支持泛型字典的直接映射。需转换为可序列化的结构（如数组、列表或自定义包装类）后再处理。
使用包装类 + XmlSerializer（推荐）
定义一个包含 KeyValuePair<K,V> 列表的容器类，让 XmlSerializer 能识别并生成标准 XML：
- 创建如
SerializableDictionary<K,V>类，内部用List<KeyValuePair<K,V>>存储数据 - 提供
ToDictionary()和FromDictionary()方法实现双向转换 - 为
KeyValuePair的 Key/Value 添加 [XmlElement] 特性（注意：.NET 6+ 可直接序列化 KeyValuePair，旧版本建议封装为独立属性类）
示例关键代码：
[XmlRoot("Dictionary")]
public class SerializableDictionary<K, V>
{
[XmlElement("Item")]
public List<DictionaryEntry> Items { get; set; } = new();
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">public SerializableDictionary() { }
public SerializableDictionary(Dictionary<K, V> dict)
{
foreach (var kvp in dict)
Items.Add(new DictionaryEntry(kvp.Key, kvp.Value));
}
public Dictionary<K, V> ToDictionary() =>
Items.ToDictionary(x => (K)x.Key, x => (V)x.Value);}
public class DictionaryEntry { [XmlElement("Key")] public object Key { get; set; } [XmlElement("Value")] public object Value { get; set; public DictionaryEntry() { } public DictionaryEntry(object key, object value) => (Key, Value) = (key, value); }
用 DataContractSerializer（支持泛型字典）
DataContractSerializer 原生支持 Dictionary<K,V>，无需额外包装，但生成的 XML 带命名空间和冗余结构（如 <KeyValueOfstringstring>），可读性较差：
- 需为键值类型添加
[DataContract]，键/值属性加[DataMember] - 序列化时指定
Dictionary<string,string>类型，不需中间类 - 适合内部服务通信，不太适合人读或与第三方 XML 约定交互
注意：若键或值是复杂类型，必须确保它们也标记为 DataContract。
转为 List<KeyValuePair> 后序列化（轻量替代）
如果只是临时导出、且键值类型简单（如 string/int），可跳过自定义类，直接转成列表再序列化：
-
var list = dict.ToList();得到List<KeyValuePair<string, int>> - 用
XmlSerializer序列化该 list（需确保 KeyValuePair 的 Key/Value 是 public 属性；.NET Core 3.1+ 支持直接序列化 KeyValuePair） - 生成的 XML 是扁平 item 列表，无“dictionary”语义，但结构清晰、易解析
避免踩坑的关键细节
常见问题及应对：
-
键类型限制：XML 元素名不能含特殊字符，若 key 是字符串且含空格/斜杠，建议用
[XmlAttribute]存为属性而非元素，或预处理 key 名 -
空值处理：默认
XmlSerializer不序列化 null 值；若需保留，给属性加[XmlElement(IsNullable = true)] -
性能考虑：大量数据时，优先选
XmlSerializer预生成程序集（使用XmlSerializer(Type)构造一次缓存），避免每次新建开销 -
反序列化安全：禁用
XmlSerializer.UnsafeDeserialize，始终验证输入 XML 结构，防止 XXE 攻击
