课时

我们来看看如何用 System.Text.Json 序列化和反序列化数组 T[] 和列表 List<T>：哪些 C# 集合对应 JSON 数组，如何把数据保存到文件再读回来，遇到 null、空集合和多态时要注意什么。全部用直观的文件示例和序列化器设置来讲解。

如何用 System.Text.Json 对字典进行 JSON 序列化和反序列化：从字符串键的简单情况，到数字键和嵌套对象。会讲为什么复杂对象不能作为键、 JsonSerializerOptions（比如 PropertyNamingPolicy）如何影响结果，以及什么时候应该把字典换成键值对列表。包含实战例子、JSON 片段和常见坑解析。

在这节讲座里我们会讲如何用 System.Text.Json 序列化和反序列化多层次结构：树、可能有环的图、嵌套集合和属性。会讨论 JsonSerializer、选项 ReferenceHandler. IgnoreCycles、属性 JsonIgnore、通过标识符保存引用的方式，以及实际项目中的实用模式（目录、员工、作者/书籍）。

在这节课里我们讲什么是循环引用以及为什么它会弄坏序列化：默认情况下 System.Text.Json 在发现循环时会抛出 JsonException。我们会看一些可行的方案：清理引用、属性 [JsonIgnore]、用标识符替代嵌套对象，以及通过 ReferenceHandler. Preserve 打开引用序列化。顺带比较一下 Newtonsoft.Json 的能力，并给出面向 REST API 的实用建议。

如何把集合及其字段从序列化中隐藏，把属性重命名以满足 API 合约，在 System.Text.Json 中管理 null 值和输出格式。我们会拆解特性 [JsonIgnore]、 [JsonPropertyName]、选项 JsonSerializerOptions，对字典的处理、常见陷阱以及面试中常见的实战问题。