在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);
如果只是临时提取个别字段,不想定义完整类,可以用 JsonDocument 或 JsonElement:
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。
