C#怎么读取JSON文件 C#解析JSON字符串方法

来源:这里教程网 时间:2026-02-21 17:34:05 作者:

在C#中读取JSON文件和解析JSON字符串,最常用、推荐的方式是使用 System.Text.Json(.NET Core 3.0+ 和 .NET 5+ 内置)或 Newtonsoft.Json(即 Json.NET,兼容性更广)。下面分两种常见场景说明,重点讲清怎么做、注意什么。

读取本地JSON文件并反序列化为对象

假设你有一个

config.json
文件,内容如下:

{
  "name": "张三",
  "age": 28,
  "isActive": true
}

对应定义一个 C# 类:

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
    public bool IsActive { get; set; }
}

System.Text.Json 读取并解析:

using System.Text.Json;
<p>string json = File.ReadAllText("config.json");
Person person = JsonSerializer.Deserialize<Person>(json);

✅ 小提示:

属性名默认按 PascalCase 匹配 JSON 中的 camelCase 字段(如
Name
"name"
),无需额外配置
如果 JSON 字段名和类属性不一致,可用
[JsonPropertyName("xxx")]
特性标注
文件路径不存在会抛出
FileNotFoundException
,建议加 try-catch 或先判断
File.Exists()

解析JSON字符串(非文件)

比如从 API 接口拿到一段 JSON 字符串:

string jsonString = @"{""id"":123,""title"":""Hello World""}";

同样用

JsonSerializer.Deserialize<t>()</t>
即可:

var obj = JsonSerializer.Deserialize<MyModel>(jsonString);

如果只是临时提取个别字段,不想定义完整类,可以用 JsonDocumentJsonElement

using JsonDocument doc = JsonDocument.Parse(jsonString);
string title = doc.RootElement.GetProperty("title").GetString(); // 返回 "Hello World"

✅ 这种方式适合结构不固定、只取少量字段的场景,性能好、内存占用低。

用 Newtonsoft.Json(Json.NET)的写法(兼容老项目)

安装 NuGet 包:

Install-Package Newtonsoft.Json

读取文件:

string json = File.ReadAllText("data.json");
Person p = JsonConvert.DeserializeObject<Person>(json);

解析字符串:

JObject jObj = JObject.Parse(jsonString);
string title = jObj["title"]?.ToString();

✅ 它支持更多格式(如注释、单引号)、语法更灵活,但 System.Text.Json 性能更好、更轻量,新项目优先选它。

常见问题提醒

中文乱码?确保 JSON 文件保存为 UTF-8 编码(VS里右键文件 → 高级保存选项) 反序列化失败?检查 JSON 格式是否合法(可用在线工具校验),以及类型是否匹配(如字符串不能转成 int) 嵌套对象或数组?类中对应属性用
List<t></t>
或子类即可,自动映射
忽略某个字段?System.Text.Json 用
[JsonIgnore]
;Newtonsoft 用
[JsonIgnore]
[JsonProperty(Required = Required.Default)]

基本上就这些。选 System.Text.Json 是当前主流,简单、快、无第三方依赖;有特殊需求(比如需要动态处理或兼容旧代码)再上 Newtonsoft.Json。

相关推荐