.NET Core 3.0+ 推荐使用 System.Text.Json，性能好、内存占用低、默认安全，仅序列化 public 属性（需 getter），私有字段需 [JsonInclude] 或 IncludeFields=true；循环引用会抛异常，需提前处理；日期默认 ISO 8601 格式；Newtonsoft.Json 更灵活，支持循环引用忽略、自定义转换器、私有成员序列化等，适合旧项目或复杂需求。
用 System.Text.Json 序列化对象（.NET Core 3.0+ 推荐）
这是目前官方主推的方式，性能好、内存占用低、默认安全（不序列化私有字段或非公共属性，除非显式配置）。
- 确保目标类的属性是
public且有 getter（否则默认不会被序列化） - 若需包含私有字段，加
[JsonInclude]或用JsonSerializerOptions配置IncludeFields = true - 处理循环引用会直接抛出
System.Text.Json.JsonException，需提前断开引用或改用Newtonsoft.Json - 日期默认输出为 ISO 8601 格式（如
"2024-05-20T14:30:00"），无需额外配置
using System.Text.Json;
var person = new { Name = "Alice", Age = 30 };
string json = JsonSerializer.Serialize(person); // → {"Name":"Alice","Age":30}
用 Newtonsoft.Json（Json.NET）序列化（兼容旧项目/需要高级功能）
如果你在 .NET Framework 项目中，或依赖 ReferenceLoopHandling、自定义转换器、JsonProperty 别名等特性，仍需它。
- 安装 NuGet 包：
Newtonsoft.Json - 默认允许序列化私有字段（取决于访问修饰符和
JsonSerializerSettings） - 循环引用可通过
ReferenceLoopHandling.Ignore静默跳过，但可能丢失数据 -
DateTime默认按本地时区格式化，易引发时区混淆，建议显式设DateFormatHandling.IsoDateFormat
using Newtonsoft.Json;
var person = new { Name = "Bob", BirthDate = DateTime.Now };
string json = JsonConvert.SerializeObject(person,
new JsonSerializerSettings { DateFormatHandling = DateFormatHandling.IsoDateFormat });
遇到 NotSupportedException 或空 JSON（如 {}）怎么办？
常见于属性无 getter、类型不可序列化（如 IntPtr、委托、未标记 [Serializable] 的自定义类）、或用了匿名类型但运行时环境限制。
JSON.NET 简单的使用 中文WORD版
下载
本文档主要讲述的是JSON.NET 简单的使用；JSON.NET使用来将.NET中的对象转换为JSON字符串（序列化），或者将JSON字符串转换为.NET中已有类型的对象（反序列化？）。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
- 检查属性是否真有 public getter：字段（
public string Name;）不会被序列化，必须是属性（public string Name { get; set; }） - 若类含不可序列化成员，加
[JsonIgnore]（Newtonsoft）或[JsonIgnore]+System.Text.Json.Serialization命名空间（.NET 5+） - 使用
dynamic或ExpandoObject时，System.Text.Json默认不支持，得换Newtonsoft.Json - Unity 用户注意：IL2CPP 构建下
System.Text.Json可能因 AOT 限制失败，优先用 Json.NET
要不要手动处理缩进或编码？
一般不需要。调试时才开启缩进；中文乱码基本不存在——两个库默认都用 UTF-8 编码写入字符串。
- 美化输出（仅调试）：
JsonSerializerOptions.WriteIndented = true或Formatting.Indented - 想把 JSON 写入文件并确保 BOM？别手动加——
File.WriteAllText(path, json, Encoding.UTF8)即可，UTF-8 不带 BOM 是标准做法 - 若接口要求严格小写 key，用
JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase
var options = new JsonSerializerOptions { WriteIndented = true, PropertyNamingPolicy = JsonNamingPolicy.CamelCase };
string json = JsonSerializer.Serialize(person, options); // → { "name": "Alice", "age": 30 }
实际用哪个，取决于你用的 .NET 版本、是否已有 Json.NET 依赖、以及有没有循环引用或动态类型需求。.NET 6+ 新项目，闭眼用 System.Text.Json；老项目或要快速绕过序列化限制，Newtonsoft.Json 仍是更省心的选择。 
