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
相关产品推荐
相关产品推荐

