cc怎么读取json

CC中如何高效读取JSON数据：从基础到实践的全面指南

在当今的软件开发中,JSON（JavaScript Object Notation）因其轻量级、易读性和跨语言兼容性，已成为数据交换的主流格式之一，无论是配置文件、API响应还是数据存储，JSON都无处不在，而在C#（通常简称为“CC”，即C#的缩写）中，读取JSON数据是开发者必备的核心技能，本文将从基础概念出发，逐步到不同场景下的JSON读取方法，涵盖原生序列化库、第三方高性能库以及动态解析技巧，帮助开发者C#中高效读取JSON的完整方案。

JSON与C#：为什么需要读取JSON？

JSON是一种基于文本的数据格式,以键值对（Key-Value）的形式组织数据，结构清晰，易于人类阅读和机器解析，在C#应用中，读取JSON数据的场景非常广泛，

• 调用RESTful API时，解析服务器返回的JSON响应；
• 读取配置文件（如appsettings.json）中的应用程序参数；
• 处理前端传递的JSON数据（如Web API中的请求体）；
• 从数据库或文件中加载结构化数据。

C#本身提供了多种方式读取JSON，从原生的System.Text.Json到流行的第三方库（如Newtonsoft.Json），开发者可以根据项目需求选择最合适的方案。

基础入门：使用System.Text.Json读取JSON

System.Text.Json是.NET Core 3.0及以上版本内置的JSON处理库，性能高、依赖少，适合大多数场景，以下是核心步骤和示例：

反序列化：将JSON字符串转换为C#对象

反序列化（Deserialization）是读取JSON的核心操作，即把JSON文本映射为C#对象，首先需要定义一个与JSON结构匹配的C#类（称为“模型类”），然后使用JsonSerializer.Deserialize方法进行转换。

示例：解析简单的JSON对象

假设有以下JSON字符串：

{
  "name": "张三",
  "age": 30,
  "isStudent": false,
  "courses": ["数学", "英语"]
}

对应的C#模型类如下：

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
    public bool IsStudent { get; set; }
    public List<string> Courses { get; set; }
}

读取JSON的代码：

using System;
using System.Text.Json;
using System.Collections.Generic;
class Program
{
    static void Main()
    {
        string json = @"{
            ""name"": ""张三"",
            ""age"": 30,
            ""isStudent"": false,
            ""courses"": [""数学"", ""英语""]
        }";
        // 反序列化为Person对象
        Person person = JsonSerializer.Deserialize<Person>(json);
        // 输出结果
        Console.WriteLine($"姓名: {person.Name}");
        Console.WriteLine($"年龄: {person.Age}");
        Console.WriteLine($"是否学生: {person.IsStudent}");
        Console.WriteLine("课程: " + string.Join(", ", person.Courses));
    }
}

输出结果：

姓名: 张三
年龄: 30
是否学生: False
课程: 数学, 英语

处理复杂JSON结构：嵌套对象与数组

JSON数据往往包含嵌套对象或数组,此时需要模型类多层映射。

{
  "school": "XX大学",
  "student": {
    "id": "1001",
    "name": "李四",
    "scores": {
      "math": 90,
      "english": 85
    }
  }
}

对应的C#模型类：

public class SchoolInfo
{
    public string School { get; set; }
    public Student Student { get; set; }
}
public class Student
{
    public string Id { get; set; }
    public string Name { get; set; }
    public Scores Scores { get; set; }
}
public class Scores
{
    public int Math { get; set; }
    public int English { get; set; }
}

读取嵌套JSON的方式与简单JSON一致,只需确保模型类结构匹配即可：

string json = @"{
    ""school"": ""XX大学"",
    ""student"": {
        ""id"": ""1001"",
        ""name"": ""李四"",
        ""scores"": {
            ""math"": 90,
            ""english"": 85
        }
    }
}";
SchoolInfo schoolInfo = JsonSerializer.Deserialize<SchoolInfo>(json);
Console.WriteLine($"学校: {schoolInfo.School}");
Console.WriteLine($"学生: {schoolInfo.Student.Name}, 数学成绩: {schoolInfo.Student.Scores.Math}");

处理JSON数组：转换为C#集合

JSON数组（用[]表示）可以直接反序列化为C#的集合类型（如List<T>、Array）。

[
  { "id": 1, "name": "商品A" },
  { "id": 2, "name": "商品B" }
]

读取方式：

string json = @"[
    { ""id"": 1, ""name"": ""商品A"" },
    { ""id"": 2, ""name"": ""商品B"" }
]";
List<Product> products = JsonSerializer.Deserialize<List<Product>>(json);
foreach (var product in products)
{
    Console.WriteLine($"ID: {product.Id}, 名称: {product.Name}");
}
public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
}

System.Text.Json的常用配置选项

在实际开发中,JSON数据可能与C#模型不完全匹配（如属性名不一致、忽略空值等），此时可以通过JsonSerializerOptions进行配置：

var options = new JsonSerializerOptions
{
    // 属性名不区分大小写
    PropertyNameCaseInsensitive = true,
    // 忽略null值的属性
    IgnoreNullValues = true,
    // 自定义属性命名策略（如驼峰转帕斯卡）
    PropertyNamingPolicy = JsonNamingPolicy.CamelCase
};
Person person = JsonSerializer.Deserialize<Person>(json, options);

进阶选择：使用Newtonsoft.Json（Json.NET）

尽管System.Text.Json已成为.NET内置标准，但Newtonsoft.Json（Json.NET）凭借其丰富的功能和灵活性，仍被许多项目广泛使用，尤其对于旧项目迁移或需要高级特性（如LINQ to JSON）的场景，Newtonsoft.Json是更优选择。

基本反序列化（与System.Text.Json类似）

首先通过NuGet安装Newtonsoft.Json包，然后使用JsonConvert.DeserializeObject方法：

using Newtonsoft.Json;
using System.Collections.Generic;
string json = @"{
    ""name"": ""王五"",
    ""age"": 25,
    ""courses"": [""物理"", ""化学""]
}";
Person person = JsonConvert.DeserializeObject<Person>(json);
Console.WriteLine($"姓名: {person.Name}");

核心优势：LINQ to JSON动态解析

Newtonsoft.Json的JObject、JArray等类允许直接操作JSON数据，无需预先定义模型类，非常适合结构不固定或仅需提取部分数据的场景。

示例：动态解析JSON

using Newtonsoft.Json.Linq;
using System;
string json = @"{
    ""school"": "XX大学",
    ""student"": {
        ""id"": ""1002"",
        ""name"": ""赵六"",
        ""scores"": { ""math"": 88, ""english"": 92 }
    }
}";
// 解析为JObject
JObject jObject = JObject.Parse(json);
// 直接提取字段
string school = jObject["school"]?.ToString();
string studentName = jObject["student"]["name"]?.ToString();
int mathScore = (int)jObject["student"]["scores"]["math"];
Console.WriteLine($"学校: {school}");
Console.WriteLine($"学生: {studentName}");
Console.WriteLine($"数学成绩: {mathScore}");

特性标记：灵活控制序列化行为

Newtonsoft.Json通过特性（Attribute）提供更精细的控制，

public class Person
{
    [JsonProperty("name")] // 指定JSON属性名
    public string Name { get; set; }
    [JsonIgnore] // 忽略此属性，不参与序列化
    public string Password { get; set; }
    [JsonProperty("age")]
    public int Age { get; set; }
}

在反序列化时,[JsonProperty]会匹配JSON中的"name"字段，而[JsonIgnore]会跳过Password字段。

高级场景：处理动态JSON与异常

动态对象：dynamic与ExpandoObject

当JSON结构完全动态（如配置文件字段可能变化）时，可以使用dynamic类型直接解析，避免定义模型类：

using System;
using System.Text.Json;
string json = @"{
    ""config"": {
        ""timeout"":