Unity 数据读取Json文件解析（Newtonsoft.Json ，Litjson）

原创已于 2025-07-31 17:03:48 修改 · 747 阅读

CC 4.0 BY-SA版权

文章标签：

于 2025-07-31 17:01:56 首次发布

1. 前言
JSON文件是一种纯文本文件，用于存储数据，并且是基于JavaScript的一个子集。JSON文件通常用于存储和传输数据，以及在应用程序之间交换信息。它们以键值对的形式存储数据，其中键是字符串，值可以是字符串、数字、布尔值、数组、对象或null。
JSON文件通常具有.json扩展名，例如example.json。在JSON文件中，数据以层次结构的形式组织，可以表示嵌套的对象和数组。JSON文件通常用于存储配置信息、数据交换和持久化存储。
可以在https://www.json.org 了解关于JSON的更多信息。
2. 优缺点
JSON文件的优点包括：
语法简单：JSON的语法非常简单，易于学习和使用，它基于JavaScript的一个子集，因此熟悉JavaScript的开发者可以很容易地使用JSON。
数据结构清晰：JSON以键值对的形式存储数据，层次结构分明，使得数据的组织形式非常清晰，易于理解和处理。
轻量级：JSON文件是纯文本文件，存储的数据量相对较小，比较轻量级，适合存储和传输大量数据。
支持跨平台：JSON文件是跨平台的，可以在不同的操作系统和设备上使用，使得数据的共享和交换更加方便。
然而，JSON文件也存在一些缺点：
不支持注释：JSON文件不支持注释，这使得代码的维护和阅读变得困难。
安全性问题：如果与不受信任的服务或不受信任的浏览器一起使用JSON，可能会存在安全漏洞，使得数据易受攻击。
无法直接编辑：JSON文件是纯文本文件，无法像XML文件那样在文本编辑器中直接编辑，需要使用专门的工具或编程语言进行解析和编辑。
无法存储函数或类：JSON只能存储数据，无法存储函数或类等复杂的数据结构，这限制了JSON的使用范围。

3. 解析

格式模板
```
{  
  "name": "John",  
  "age": 30,  
  "married": true,  
  "address": {  
    "street": "123 Main St",  
    "city": "New York",  
    "state": "NY",  
    "postal_code": "10001"  
  },  
  "phone_numbers": [  
    "555-1234",  
    "555-5678"  
  ],  
  "career": null,  
  "hobbies": ["reading", "traveling"]  
}
```
3.1 Newtonsoft.Json
3.1.1 下载地址
地址：https://github.com/JamesNK/Newtonsoft.Json/releases
官网地址: 官网
3.1.2 优缺点
优点：
解析速度快：Newtonsoft.Json 的解析速度非常快，特别适合处理大量的 JSON 数据。
支持多种数据格式：Newtonsoft.Json 可以解析多种数据格式的 JSON 数据，包括数组、对象、字符串、数字等等。
可扩展性强：Newtonsoft.Json 提供了丰富的扩展接口和选项，方便开发者进行定制和扩展。
可以解析复杂的Json，不需要和Json字段一对一
缺点：
无法使用 IL2CPP 方式打包：Newtonsoft.Json 不支持使用 IL2CPP 方式打包，这可能会限制其在某些特定环境下的适用性。
解析报错：使用 Newtonsoft.Json 解析 JSON 数据时，如果 JSON 数据格式有误，可能会导致程序崩溃或者出现不可预测的行为。
无法加密包体：Newtonsoft.Json 不支持对序列化后的数据进行加密，这可能会导致数据泄露或者被篡改。
3.1.3 解析

JsonConvert.DeserializeObject(json);将一个json字符串解析成一个类对象。

Person person = JsonConvert.DeserializeObject<Person>(json);

JsonConvert.SerializeObject;将一个类对象转化成一个json字符串

string jsonStr = JsonConvert.SerializeObject(person);

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using Newtonsoft.Json;
using System;
using System.IO;
using TreeEditor;
using static MrTang;
using Newtonsoft.Json.Converters;
using Newtonsoft.Json.Linq;


public class Student
{
    public int age;
    public string name;

    public Student(int age, string name)
    {
        this.age = age;
        this.name = name;
    }
}

public class MrTang
{
    public string name;
    public int age;
    public bool sex;
    public float testF;
    public double testD;
    public DateTime BirthDate;
    public UserStatus userStatus;


    public int[] ids;
    public List<int> ids2;
    public Dictionary<int, string> dic;
    public Dictionary<string, string> dic2;

    public Student s1;
    public List<Student> s2s;

    private int privateI = 1;
    protected int protectedI = 2;
}

//public class RoleData
//{
//    public List<RoleInfo> list;
//}

public class RoleInfo
{
    public string name;
    public int age;
    public bool sex;
    public float testF;
    public double testD;
   //public DateTime BirthDate;

}
//枚举类型
//[JsonConverter(typeof(StringEnumConverter))]    
//枚举值序列化为字符串 userStatus=NotConfirmed; 不加则为0；
public enum UserStatus
{
    NotConfirmed,
    Active,
    Deleted
}


public class TestScript : MonoBehaviour
{
    // Start is called before the first frame update
    void Start()
    {
        MrTang t = new MrTang();
        t.name = "大强";
        t.age = 18;
        t.sex = true;
        t.testF = 1.4f;
        t.testD = 1.4;
        t.BirthDate=new DateTime(1990, 1, 1);
        t.userStatus = UserStatus.NotConfirmed;

        t.ids = new int[] { 1, 2, 3, 4 };
        t.ids2 = new List<int>() { 1, 2, 3 };
        t.dic = new Dictionary<int, string>() { { 1, "123" }, { 2, "234" } };
        t.dic2 = new Dictionary<string, string>() { { "1", "123" }, { "2", "234" } };

        t.s1 = null;//new Student(1, "小红");
        t.s2s = new List<Student>() { new Student(2, "小明"), new Student(3, "小强") };

        //序列化
       string json = JsonConvert.SerializeObject(t);
       File.WriteAllText(Application.persistentDataPath + "/MrTang.json", json);
        //反序列化
       json = File.ReadAllText(Application.persistentDataPath + "/MrTang.json");
       MrTang mrtang = JsonConvert.DeserializeObject<MrTang>(json);
       print(mrtang.dic[1]);
       print(mrtang.dic2["1"]);
       //日期格式自定义
        var settings = new JsonSerializerSettings
        {
            DateFormatString = "yyyy-MM-dd"  //BirthDate :1990-01-01
        };
        string jsonWithCustomDate = JsonConvert.SerializeObject(t, settings);
        File.WriteAllText(Application.persistentDataPath + "/MrTang2.json", jsonWithCustomDate);

        //读取数据集合
        //方法一
        json = File.ReadAllText(Application.persistentDataPath + "/Test.json");
        List<RoleInfo> list = JsonConvert.DeserializeObject<List<RoleInfo>>(json);
        
        foreach (var person in list)
        {
            print(person.name);
            print(person.age);
        }
        //方法二 LINQ to JSON：通过 JObject、JArray 动态操作 JSON
        JArray peopleArray = JArray.Parse(json);
        
        foreach (JObject person in peopleArray)
        {
            print("jr "+person["name"]); // 直接通过键名访问
        }

    }

}

3.2 listjson
3.2.1 下载地址
地址：https://github.com/LitJSON/litjson
3.2.2 优缺点
listjson文件的优点包括：
轻量级和高效：LitJson 的核心库非常小，没有任何外部依赖，因此它可以快速地被加载和使用。此外，LitJson 在解析和生成 JSON 数据时非常高效，可以处理大量的 JSON 数据而不会导致性能问题。
支持多种数据类型：LitJson 支持常见的 JSON 数据类型，如字符串、数字、布尔值、数组和对象等。这使得它能够满足大多数 JSON 数据处理的需求。
易于使用：LitJson 的 API 设计得非常简洁易用，使得开发者可以方便地进行 JSON 数据的序列化和反序列化操作。它提供了易于使用的函数和方法，以及对 JSON 数据的直观封装和操作。
强大的序列化功能：LitJson 提供了强大的序列化功能，可以将 C# 对象序列化为 JSON 数据，并且支持将 JSON 数据反序列化为 C# 对象。这使得开发者可以轻松地将数据在 C# 对象和 JSON 数据之间进行转换。
缺点：
不支持自定义属性：虽然 LitJson 支持将大多数 C# 对象序列化为 JSON 数据，但它不支持将自定义属性序列化为 JSON。这意味着如果您的 C# 对象包含自定义属性，LitJson 可能无法正确地序列化这些属性。
JSON字符串中的key也需要和类字段的名字完全一致，如果不对应的话会解析失败。
不支持跨平台：由于 Unity 的跨平台特性，LitJson 可能无法在所有平台上使用。这可能会限制其在某些特定环境下的适用性。
可能存在内存泄漏：在使用 LitJson 的过程中，如果频繁地进行 JSON 数据的序列化和反序列化操作，可能会导致内存泄漏的情况。这主要是因为 Unity 的内存管理机制所致，但可以通过合理的内存管理和使用来解决这个问题。
3.2.3 解析
JsonMapper.ToObject(json)：将一个json字符串解析成一个类对象

Person person = JsonMapper.ToObject<Person>(str);
// 解析json字符串
JsonData jsonData = JsonMapper.ToObject(jsonStr);
// 根据json的对象名来获取数据
Debug.Log("name = " + (string)jsonData["name"]);