最稳妥方式是直接用 system.text.json.jsonserializer.serialize 配合 file.writealltext，显式指定 encoding.utf8，避免手动拼接、乱码、非法 json；需排除 type 等不可序列化类型，空对象应判空处理，中文转义可通过 javascriptencoder.unsaferelaxedjsonescaping 关闭。
用 JsonSerializer.Serialize 写入 JSON 文件最稳妥
直接调用 System.Text.Json.JsonSerializer.Serialize + File.WriteAllText 是 .NET 5+ 推荐方式，不依赖第三方库，性能好、默认安全。别再用过时的 JsonConvert.SerializeObject（Newtonsoft）除非项目强绑定旧代码。
常见错误是把对象序列化后手动拼字符串再写入，比如先 ToString() 再写文件——这会破坏转义和编码，尤其含中文或特殊字符时直接生成非法 JSON。
- 正确写法：
var data = new { Name = "张三", Age = 28 };<br>string json = JsonSerializer.Serialize(data, new JsonSerializerOptions { WriteIndented = true });<br>File.WriteAllText("user.json", json, Encoding.UTF8); - 必须显式传
Encoding.UTF8，否则 Windows 默认 ANSI 编码，中文变乱码 - 若对象含
DateTime，默认输出格式是 ISO 8601（如"2024-05-20T14:30:00"），无需额外配置；但若需自定义格式，得用JsonConverter，不是改ToString()
写入时抛出 NotSupportedException: Serialization and deserialization of 'System.Type' instances are not supported
这是典型反射型对象误序列化：比如类里有 Type、MethodInfo、Delegate 或未标记 [Serializable] 的非公共字段。JSON 格式无法表达这些运行时类型信息。
常见场景：DTO 类继承了含 GetType() 返回值的基类，或用了 object 字段存了委托/类型实例。
- 检查目标对象所有属性类型，排除
Type、Assembly、MethodInfo等运行时类型 - 用
[JsonIgnore]跳过有问题的属性（加在属性上，不是字段） - 不要试图用
JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter())解决这个问题——它只管枚举，不处理类型元数据 - 若必须保留某些元数据，应提前转换为字符串或字典，例如：
TypeName = typeof(MyClass).FullName
写入空对象或 null 导致文件内容为 null 而不是空 JSON 对象
当序列化的对象是 null，JsonSerializer.Serialize 默认输出字符串 "null"，而不是 {}。这会让下游解析失败，尤其前端 JS 用 JSON.parse() 时直接报错。
这不是 bug，是设计行为——JSON 规范中 null 是合法值，但业务上常需要“空对象占位”。
- 写入前做空值判断：
if (data == null) data = new object(); - 或统一用可空包装类，如
MyDto?配合JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull，但这只跳过字段，不改变根对象为 null 的行为 - 更可靠的做法是封装一个写入方法：
public static void WriteJson<t>(string path, T value, JsonSerializerOptions options = null)<br>{<br> var json = value switch<br> {<br> null => "{}",<br> _ => JsonSerializer.Serialize(value, options ?? new JsonSerializerOptions { WriteIndented = true })<br> };<br> File.WriteAllText(path, json, Encoding.UTF8);<br>}</t>
中文写入后显示为 Unicode 转义（如 \u5f20\u4e09）
这是 JsonSerializerOptions 默认启用 Encoder 导致的——它为防 XSS 强制转义非 ASCII 字符。开发阶段看着难受，部署到 Web API 时反而合理；但写配置文件或日志时，显然要可读。
注意：这不是编码问题（UTF-8 没错），是序列化器主动编码策略。
- 关闭转义只需一行：
options.Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping; - 不要用
new UTF8Encoding(false)替代——它解决不了这个现象 - 该设置不影响安全性，因为写入文件不涉及浏览器渲染；但若该 JSON 后续被 Web 页面直接
innerHTML插入，就得自己做 HTML 转义，不能依赖这个设置 - 如果只对特定字符串字段禁用转义，应自定义
JsonConverter<string></string>，而非全局改 Encoder
Directory.CreateDirectory(Path.GetDirectoryName(path)) 并捕获 UnauthorizedAccessException。
