Unity3D序列化机制详解

前言

Unity3D的序列化机制是其编辑器与运行时数据管理的核心，理解其工作原理对高效开发至关重要。以下是关键点总结：

对惹，这里有一 个游戏开发交流小组，希望大家可以点击进来一起交流一下开发经验呀！

1. 序列化的作用

持久化存储：将对象状态转换为可存储格式（如场景、预制体文件），便于跨会话保存和加载。
Inspector集成：序列化字段显示在Inspector中，允许可视化编辑。
资源引用管理：保存对材质、预制体等资产的引用路径。

2. 支持的数据类型

基本类型 ：int, float, string, bool等。
Unity内置类型 ：Vector3, GameObject, Transform等。
自定义类型 ：需标记为[System.Serializable]，且字段类型也需可序列化。
数组/列表 ：List<T>, T[]（但T需可序列化）。
不支持类型 ：如Dictionary<TKey, TValue>，需自定义序列化方案。

3. 控制序列化的方式

Public字段 ：默认序列化（除非标记[NonSerialized]）。
Private/Protected字段 ：需添加[SerializeField]属性。
排除序列化 ：使用[NonSerialized]（C#）或[System.NonSerialized]。
条件序列化 ：通过#if UNITY_EDITOR结合[SerializeField]控制编辑器专用字段。

4. 序列化流程

编辑时：保存场景/预制体时，序列化所有可序列化字段。
运行时 ：反序列化场景/预制体数据初始化对象；ScriptableObject资源按需加载。
YAML格式：Unity将序列化数据转换为YAML（人类可读），便于版本控制。

5. 自定义序列化

ISerializationCallbackReceiver接口 ：实现OnBeforeSerialize和OnAfterDeserialize方法，用于处理复杂类型（如字典）或数据迁移。

public class CustomSerialization : MonoBehaviour, ISerializationCallbackReceiver {
public Dictionary<int, string> data = new Dictionary<int, string>();

复制代码

  [SerializeField] private List<int> _keys;
  [SerializeField] private List<string> _values;
  
  public void OnBeforeSerialize() {
      _keys = new List<int>(data.Keys);
      _values = new List<string>(data.Values);
  }
  
  public void OnAfterDeserialize() {
      data.Clear();
      for (int i = 0; i < _keys.Count; i++)
          data[_keys[i]] = _values[i];
  }

}

6. 预制体与场景序列化

预制体差异：实例化预制体后，修改的属性以覆盖形式序列化，确保高效存储。
引用保存：通过唯一ID（如GUID）或本地ID维护资源引用，避免路径依赖问题。

7. 常见问题与解决方案

字段丢失/重置 ：
- 确保字段可序列化，避免使用不支持类型。
- 重命名字段时使用[FormerlySerializedAs("oldName")]保留旧数据。
循环引用：Unity通过引用ID处理，但需避免逻辑依赖导致的死锁。
版本迁移：

[SerializeField, HideInInspector]
private int legacyValue;

private void OnValidate() {
if (legacyValue != 0) {
newValue = legacyValue;
legacyValue = 0;
}
}

8. 性能优化

减少序列化数据量 ：避免大型数组/列表，使用[Range]或[TextArea]限制Inspector输入。
ScriptableObject：将静态数据移至ScriptableObject，减少场景文件大小。
惰性加载 ：对非必要数据使用[NonSerialized]，运行时动态加载。

9. 最佳实践

最小化序列化字段 ：仅暴露必要字段到Inspector，其余设为私有并初始化于Awake()。
使用属性替代公共字段 ：避免意外修改，通过[SerializeField]结合属性保护数据。

[SerializeField]
private int _health;
public int Health => _health;
版本兼容性测试：升级脚本后，验证旧场景/预制体加载是否正常，利用回调处理迁移。

示例：自定义可序列化类

复制代码

[System.Serializable]
public class WeaponStats {
    public string name;
    public int damage;
    public float fireRate;
}

public class Player : MonoBehaviour {
    [SerializeField]
    private List<WeaponStats> weapons; // 显示在Inspector并可编辑
}

理解并合理运用Unity的序列化机制，能显著提升开发效率，确保数据持久化与工作流顺畅。遇到问题时，结合文档、实验与调试工具（如Inspector中的序列化数据视图）进行排查。