You need to enable JavaScript to run this app. Unity C#中可重载类型JSON属性的解析适配方案
优惠活动
大模型
产品
解决方案
定价
更多

Unity C#中可重载类型JSON属性的解析适配方案

Unity 适配双格式可重载JSON属性的实现方案

当前核心痛点为 cost 字段同时兼容纯数值、嵌套对象两种JSON格式,原生 JsonUtility 采用强类型绑定反序列化逻辑,字段类型与定义不匹配时会直接抛出解析错误,无法在解析流程中动态判断字段类型,可根据项目依赖情况选择两种实现路径:

路径1:仅使用内置 JsonUtility 实现

核心思路是在调用反序列化方法前,对原始JSON字符串做格式归一化预处理,把所有非标准格式转换为和C#类结构匹配的统一格式,再走正常解析流程。

  • 第一步,定义和目标统一结构完全匹配的可序列化类:
    [Serializable]
    public class MyEntry
    {
        public int @base;
        public int inc; // 简化格式下该字段无赋值,保持默认0即可
    }
    
    [Serializable]
    public class MyObject
    {
        public MyEntry cost;
    }
    
  • 第二步,实现预处理逻辑:
    定位原始JSON中"cost"字段的位置,必须先跳过JSON字符串值区域的同名匹配(比如避免把"desc": "cost: 5"这类文本内容误识别),再判断字段值的类型:
    • 如果值为纯数值,自动将字段替换为"cost": {"base": 数值, "inc": 0}的结构
    • 如果值为嵌套对象,不做任何修改

    注意:如果直接用通用正则匹配,很容易出现文本误匹配的问题,简单场景下可先用游标扫描JSON字符,跳过引号包裹的字符串区域后再做字段识别,稳定性更高。

  • 第三步,将预处理后的JSON字符串传入JsonUtility.FromJson<MyObject>()完成解析,即可解决类型不匹配的问题。

路径2:使用内置集成的Newtonsoft.Json实现

Unity 2020及以上版本已内置支持Newtonsoft.Json(即Json.NET),该库支持自定义反序列化转换器,可在解析单个字段时动态判断JSON节点类型,直接转换为统一的业务结构,不需要手动做字符串预处理,是这类多格式适配场景的主流实现方案。

  • 第一步,给通用值类MyEntry编写自定义类型转换器,逻辑为解析字段时根据节点类型做分支处理:
    using Newtonsoft.Json;
    
    public class MyEntryConverter : JsonConverter
    {
        public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
        {
            var entry = new MyEntry();
            switch (reader.TokenType)
            {
                // 遇到纯数值格式,直接赋值给base字段
                case JsonToken.Integer:
                    entry.@base = Convert.ToInt32(reader.Value);
                    break;
                // 遇到嵌套对象格式,正常填充字段值
                case JsonToken.StartObject:
                    serializer.Populate(reader, entry);
                    break;
            }
            return entry;
        }
    
        // 如无对称序列化需求,该方法可直接抛出未实现异常
        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer) => throw new NotImplementedException();
        public override bool CanConvert(Type objectType) => objectType == typeof(MyEntry);
    }
    
  • 第二步,通过特性将转换器绑定到MyEntry类上:
    [JsonConverter(typeof(MyEntryConverter))]
    public class MyEntry
    {
        public int @base;
        public int inc;
    }
    
    public class MyObject
    {
        public MyEntry cost;
    }
    
  • 解析时直接调用JsonConvert.DeserializeObject<MyObject>(原始JSON字符串)即可,两种格式的JSON都能被正确解析为统一的C#结构。

两种方案对比

  • 纯JsonUtility方案无额外依赖,适合对包体要求极高、JSON结构非常简单的场景,缺点是预处理逻辑容易踩JSON转义的坑,扩展性较差
  • Newtonsoft.Json自定义转换器方案逻辑清晰、扩展性强,是当前处理这类多兼容格式JSON解析的通用选择

内容的提问来源于stack exchange,提问作者Frivolimous

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 03:06:03