Unity 资源目录与序列化:特殊文件夹、运行时路径、序列化规则、Prefab 与 ScriptableObject
一、特殊文件夹
| 文件夹 | 作用 | 注意 |
|---|---|---|
| Resources | 其中的资源会被打进包里,运行时通过 Resources.Load("路径") 按路径加载 | 见下文 |
| StreamingAssets | 原样复制到包里,不做任何处理 | 设备上只读;Android 上位于压缩包内部,不能用普通的文件 API 读取 |
| Editor | 编辑器脚本和资源,不会打进包里 | 运行时代码不能引用 Editor 中的类型 |
| Editor Default Resources | 编辑器脚本通过 EditorGUIUtility.Load 加载的资源 | 仅编辑器 |
| Plugins | 原生插件(.dll、.so、.a、.framework 等) | 按平台设置导入选项 |
| Gizmos | Scene 视图中的图标 | 仅编辑器 |
以 . 开头或以 ~ 结尾的文件夹 | 被 Unity 忽略,不会导入 | 适合放不想被导入的源文件 |
Resources 为什么不推荐
- 所有 Resources 中的资源都会打进包里,无论是否被使用,难以控制包体。
- 打包时会为它们生成一个索引,启动时需要加载这个索引,资源越多,启动越慢、索引占的内存越多。
- 不能热更新:它们在安装包里,只能随整包更新。
- 卸载只能靠
Resources.UnloadAsset或UnloadUnusedAssets,难以精确管理。
Unity 官方也建议正式项目尽量少用 Resources,改用 AssetBundle 或基于它的资源管理框架(见 AssetBundle)。一般只把启动最早期必须的少量资源(比如启动界面)放在 Resources 中。
二、运行时路径
| 路径 | 内容 | 设备上可读 | 设备上可写 | 用途 |
|---|---|---|---|---|
Application.dataPath | 程序自身的数据目录 | 部分 | ✗ | 一般不直接使用 |
Application.streamingAssetsPath | StreamingAssets 的位置 | ✓ | ✗ | 首包资源、随包发布的配置 |
Application.persistentDataPath | 应用的持久化目录 | ✓ | ✓ | 存档、下载的热更新资源、缓存 |
Application.temporaryCachePath | 临时缓存目录 | ✓ | ✓ | 可以被系统清理的临时文件 |
要点:
- 只有 persistentDataPath 是可写且持久的。热更新下载的资源、玩家存档都放在这里。卸载应用时会被删除。
- Android 上的 StreamingAssets 在 APK 压缩包内部,路径以
jar:file://开头。File.ReadAllText等普通文件 API 读不了,要用UnityWebRequest读取。AssetBundle.LoadFromFile是个例外,它可以直接从这个路径加载。 - 热更新的资源查找顺序通常是:先找 persistentDataPath(下载的新版本),再找 streamingAssetsPath(随包的旧版本)。
三、meta 文件与 GUID
Unity 为每个资源和文件夹生成一个同名的 .meta 文件,其中保存:
- GUID:资源的唯一标识。场景、Prefab、材质之间互相引用时,记录的是对方的 GUID,而不是路径;
- 导入设置:贴图的压缩格式、模型的导入选项等。
所以:
- 在 Unity 编辑器中移动、重命名资源,GUID 不变,引用不会断;
- 在文件管理器中移动文件、却没有一起移动 meta,或者删除了 meta,Unity 会生成新的 GUID,所有对它的引用都会丢失;
- meta 文件必须提交到版本控制。多人协作时,A 提交了资源但没提交 meta,B 那边会生成不同的 GUID,引用就乱了。
四、序列化规则
序列化决定了脚本中的哪些字段会显示在 Inspector 中、保存到场景和 Prefab 里。
会被序列化的字段
满足以下条件:
public字段,或者带[SerializeField]的非 public 字段;- 不是
static、const、readonly; - 类型是 Unity 支持序列化的类型:
| 支持 | 举例 |
|---|---|
| 基础类型 | int、float、bool、string、枚举 |
| Unity 内置类型 | Vector3、Color、Rect、AnimationCurve、LayerMask 等 |
| Unity 对象的引用 | GameObject、Transform、组件、Material、ScriptableObject 等 |
标记了 [Serializable] 的自定义类和结构体 | [Serializable] public class ItemData { ... } |
以上类型的数组和 List<T> | List<ItemData> |
不会被序列化的
| 不支持 | 说明 |
|---|---|
Dictionary | 需要自己转换(见下文) |
| 属性(property) | 只有字段会被序列化。自动属性可以用 [field: SerializeField] 序列化它的后台字段 |
多维数组、嵌套的 List(List<List<int>>) | 用包一层类的方式解决 |
| 接口、抽象类类型的字段 | 默认不支持多态,见 SerializeReference |
| 静态、只读、常量字段 |
自定义类字段的两个特点
- 不能为 null:一个
[Serializable]类型的字段,即使代码中写了= null,反序列化后也会被自动创建成一个空对象。 - 不支持多态:字段类型是
Weapon,赋值一个Sword子类,序列化后只会保存Weapon的字段,读回来就是一个Weapon。
SerializeReference
[SerializeReference] public List<ISkillEffect> effects; // 列表中可以是不同的实现类[SerializeReference] 按引用序列化:支持接口和抽象类的多态、支持 null、支持多个字段引用同一个对象。适合技能效果、行为树节点这类需要多态的配置数据。
序列化 Dictionary
实现 ISerializationCallbackReceiver,在序列化前把字典拆成两个 List,反序列化后再合并回字典:
[Serializable]public class SerializableDictionary<K, V> : ISerializationCallbackReceiver{ [SerializeField] List<K> keys = new(); [SerializeField] List<V> values = new(); public Dictionary<K, V> Dict = new();
public void OnBeforeSerialize() { keys.Clear(); values.Clear(); foreach (var kv in Dict) { keys.Add(kv.Key); values.Add(kv.Value); } }
public void OnAfterDeserialize() { Dict.Clear(); for (int i = 0; i < Mathf.Min(keys.Count, values.Count); i++) Dict[keys[i]] = values[i]; }}重命名字段
字段改名后,已保存的数据会因为找不到旧名字而丢失。用 [FormerlySerializedAs("旧名字")] 告诉 Unity 从旧名字读取数据:
[FormerlySerializedAs("hp")] public int maxHp;JsonUtility 使用的也是同一套序列化规则,所以它同样不支持 Dictionary 和属性。
五、Prefab
Prefab 是一个可以重复使用的 GameObject 模板。
| 概念 | 说明 |
|---|---|
| 实例 | 场景中由 Prefab 创建的对象,修改 Prefab 后所有实例同步更新 |
| 覆盖(Override) | 实例上被单独修改过的属性,不再跟随 Prefab |
| 嵌套 Prefab | Prefab 中包含其他 Prefab 的实例,内层 Prefab 修改后外层自动更新 |
| Prefab 变体(Variant) | 基于另一个 Prefab 创建,继承它的所有内容,只记录自己的差异。基础 Prefab 修改后,变体自动继承 |
变体的典型用法:一个基础的”敌人”Prefab,派生出”精英敌人”变体(只改了血量和材质)。修改基础 Prefab 的结构,所有变体自动更新。
运行时注意:Instantiate(prefab) 创建的是副本。不要在运行时修改 Prefab 资源本身(比如直接改 prefab.transform.localScale),在编辑器中这样做会修改磁盘上的资源。
六、ScriptableObject
[CreateAssetMenu(menuName = "Game/Weapon Config")]public class WeaponConfig : ScriptableObject{ public string weaponName; public int damage; public float cooldown; public GameObject prefab;}ScriptableObject 是不挂在 GameObject 上、作为独立资源文件存在的数据容器。
用途
| 用途 | 说明 |
|---|---|
| 配置数据 | 武器、技能、关卡的参数,可以在编辑器中直接编辑,可以引用 Prefab、贴图等资源 |
| 共享数据 | 1000 个敌人引用同一个配置,内存中只有一份;如果放在每个敌人的组件字段里,就是 1000 份 |
| 事件通道 | 用 ScriptableObject 作为事件的中介,发送方和接收方都只引用这个资源,互相解耦 |
| 编辑器工具的数据 | 工具的设置、生成器的参数 |
陷阱
- 编辑器中运行时的修改会被保存:在 Play 模式下修改 ScriptableObject 的字段,停止运行后修改不会还原,因为它是一个资源文件。而在打包后的游戏中,修改不会被保存,重启后恢复原样。所以不要把运行时会变化的状态写进 ScriptableObject,或者运行时先复制一份(
Instantiate(config))再修改。 - 不适合做存档:打包后无法写回,存档应保存到 persistentDataPath。
和配置表的对比
| ScriptableObject | Excel 配置表(导出为二进制或 JSON) | |
|---|---|---|
| 编辑 | Unity 编辑器中,可以直接拖拽引用资源 | Excel 中,策划熟悉,适合大量数据的批量编辑 |
| 引用资源 | 直接引用 | 只能写资源路径或 ID |
| 适合 | 数量少、需要引用资源的配置 | 数量大的数值配置(物品表、关卡表) |
很多项目两者结合使用:数值走配置表,与资源关联紧密的配置用 ScriptableObject。配置表的导出与校验见 配置表工具链。
常见追问
Resources 和 StreamingAssets 有什么区别?
Resources 中的资源会被处理、打包,通过 Resources.Load 加载;StreamingAssets 原样复制、只读,需要自己按文件读取。两者都在安装包内,都不能热更新。
为什么不推荐使用 Resources? 所有资源无论是否使用都打进包里;启动时要加载索引,资源越多越慢;不能热更新;卸载难以控制。
persistentDataPath 和 streamingAssetsPath 有什么区别? streamingAssetsPath 在安装包内,只读;persistentDataPath 可读写、持久保存,用于存档和下载的热更新资源。
Android 上怎么读取 StreamingAssets? 它位于 APK 压缩包内,不能用普通文件 API,要用 UnityWebRequest 读取;AssetBundle.LoadFromFile 可以直接读取。
meta 文件有什么用?删了会怎样? 保存资源的 GUID 和导入设置。资源之间通过 GUID 引用,删除 meta 会生成新的 GUID,所有引用都会丢失。
什么样的字段会被序列化? public 或带 SerializeField 的非静态、非只读字段,类型为基础类型、Unity 类型、Unity 对象引用、标记 Serializable 的自定义类型,以及它们的数组和 List。
Dictionary 怎么序列化? 实现 ISerializationCallbackReceiver,序列化前拆成两个 List,反序列化后合并回字典。
SerializeReference 和 SerializeField 有什么区别? SerializeField 按值序列化,不支持多态和 null;SerializeReference 按引用序列化,支持接口和抽象类的多态、null 以及共享引用。
Prefab 变体有什么用? 基于基础 Prefab 只记录差异,基础 Prefab 修改后变体自动继承,适合一系列相似的对象。
ScriptableObject 有什么用?有什么坑? 作为独立的数据资源,用于配置、共享数据、事件通道。坑是编辑器中运行时的修改会被保存,打包后修改又不会保存,所以不要存放运行时状态。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!