C#怎么序列化和反序列化Dictionary

C#中推荐用System.Text.Json序列化Dictionary,它轻量高效且开箱即用;Newtonsoft.Json更灵活,支持非字符串键;XmlSerializer不支持Dictionary默认序列化;BinaryFormatter已过时且不安全。

">

C# 中序列化和反序列化 Dictionary 很常见,但要注意它默认不支持 XML 序列化(因为没无参构造函数 + 索引器不满足要求),而 JSON 和二进制方式更直接可靠。

用 System.Text.Json(推荐,.NET Core 3.0+)

这是目前最轻量、高性能、且开箱即用的方式,支持泛型字典。

  • 序列化:JsonSerializer.Serialize(dictionary)
  • 反序列化:JsonSerializer.Deserialize>(json)(需指定具体类型)
  • 注意:键类型必须是 string 或可转为 string 的类型(如枚举会转成名称),否则要自定义 JsonConverter

用 Newtonsoft.Json(兼容旧项目)

功能更灵活,对非字符串键支持更好(比如用 int 当 key 也能正常序列化)。

  • 序列化:JsonConvert.SerializeObject(dict)
  • 反序列化:JsonConvert.DeserializeObject>(json)
  • 可配合 JsonSerializerSettings 控制日期格式、空值处理等

避免用 XmlSerializer(不推荐用于 Dictionary)

XmlSerializer 要求类型有无参构造函数、公共读写属性或字段,而 Dictionary 不满足这些条件,直接用会报错。

  • 若必须用 XML,可先转成 List> 再序列化
  • 或封装一层类,把字典作为 public 属性暴露,并提供无参构造函数

二进制序列化(仅限 .NET Framework 或启用 NetCoreAppCompat)

BinaryFormatter 已被标记为过时且不安全,不建议在新项目中使用。如确需二进制,可用 System.Text.Json + MemoryStream 手动转换,或选第三方库如 MessagePack。

基本上就这些,日常开发优先选 System.Text.Json,兼容老代码或需要高级控制时再上 Newtonsoft.Json。