避坑指南：Unity二维数组序列化时为什么总丢数据？教你正确实现OnBeforeSerialize

最新推荐文章于 2026-08-02 11:27:44 发布

原创

最新推荐文章于 2026-08-02 11:27:44 发布 · 568 阅读

Unity二维数组序列化数据丢失的深度剖析与实战解决方案

如果你在Unity项目中尝试过将二维数组数据序列化到Inspector面板，或者保存到ScriptableObject中，大概率经历过那种令人抓狂的时刻：明明在编辑器里填好了数据，一运行游戏，或者重新打开项目，数据就莫名其妙地消失了，只剩下一个空荡荡的数组。这不仅仅是代码写错了那么简单，它触及了Unity序列化系统一个相当核心但又鲜为人知的机制盲区。今天，我们就来彻底拆解这个问题，从底层原理到最佳实践，让你不仅知道怎么修复，更明白为什么要这么做。

很多开发者，包括一些经验丰富的同行，最初可能会把问题归咎于Unity的“bug”或者自己粗心。但实际上，这恰恰是Unity序列化系统为了性能和兼容性所做的设计取舍。二维数组、字典、链表这类复杂数据结构，Unity的序列化器并不能原生地理解和支持。当你直接声明一个public string[,] data并期望它能被完美保存时，Unity的序列化器其实只处理了它“认识”的部分，而复杂的内部结构关系则被忽略了，这就导致了数据丢失。解决这个问题的关键，不在于寻找一个“神奇”的属性标签，而在于理解并正确使用ISerializationCallbackReceiver这个接口，以及掌握EditorUtility.SetDirty的正确调用时机。这篇文章将带你绕过所有常见的坑，构建一个健壮、可维护的二维数据表解决方案。

1. 理解Unity序列化系统的“黑盒”与二维数组的困境

Unity的序列化系统是一个强大但封闭的机制。它负责将C#对象的状态转换为一种可以存储在场景文件（.unity）、预制体（.prefab）或资源文件（.asset）中的格式，并在需要时重新构建出来。这个系统主要针对的是可序列化字段（标记了[SerializeField]或public的字段），但它对数据结构的支持是有选择性的。

1.1 Unity序列化器支持与不支持的数据类型

为了清晰地了解我们能直接使用什么，什么需要绕道，我们先看下面这个表格：

数据类型	是否被Unity原生序列化支持	说明与典型问题
基本类型（int, float, string, bool）	✅ 完全支持	直接使用，无任何问题。
Unity内置类型（Vector3, Color, GameObject引用）	✅ 完全支持	Unity已为其实现序列化逻辑。
数组（一维，如 `int[]`）	✅ 支持	支持一维数组的序列化。
多维数组（如 `string[,]`, `int[][]`）	❌ 不支持	导致数据丢失的核心原因。序列化器无法处理其维度信息。
`List<T>` (T为支持的类型)	✅ 支持	泛型列表被良好支持。
`Dictionary<TKey, TValue>`	❌ 不支持	和二维数组类似，需要手动序列化方案。
自定义类/结构体	⚠️ 条件支持	类必须标记`[System.Serializable]`，且其所有字段也必须是可序列化类型。