Unity 资源目录与序列化:特殊文件夹、运行时路径、序列化规则、Prefab 与 ScriptableObject

2438 字
12 分钟
Unity 资源目录与序列化:特殊文件夹、运行时路径、序列化规则、Prefab 与 ScriptableObject

一、特殊文件夹#

文件夹作用注意
Resources其中的资源会被打进包里,运行时通过 Resources.Load("路径") 按路径加载见下文
StreamingAssets原样复制到包里,不做任何处理设备上只读;Android 上位于压缩包内部,不能用普通的文件 API 读取
Editor编辑器脚本和资源,不会打进包里运行时代码不能引用 Editor 中的类型
Editor Default Resources编辑器脚本通过 EditorGUIUtility.Load 加载的资源仅编辑器
Plugins原生插件(.dll、.so、.a、.framework 等)按平台设置导入选项
GizmosScene 视图中的图标仅编辑器
以 . 开头或以 ~ 结尾的文件夹被 Unity 忽略,不会导入适合放不想被导入的源文件

Resources 为什么不推荐#

  • 所有 Resources 中的资源都会打进包里,无论是否被使用,难以控制包体。
  • 打包时会为它们生成一个索引,启动时需要加载这个索引,资源越多,启动越慢、索引占的内存越多。
  • 不能热更新:它们在安装包里,只能随整包更新。
  • 卸载只能靠 Resources.UnloadAsset 或 UnloadUnusedAssets,难以精确管理。

Unity 官方也建议正式项目尽量少用 Resources,改用 AssetBundle 或基于它的资源管理框架(见 AssetBundle)。一般只把启动最早期必须的少量资源(比如启动界面)放在 Resources 中。

二、运行时路径#

路径内容设备上可读设备上可写用途
Application.dataPath程序自身的数据目录部分✗一般不直接使用
Application.streamingAssetsPathStreamingAssets 的位置✓✗首包资源、随包发布的配置
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
嵌套 PrefabPrefab 中包含其他 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。

和配置表的对比#

ScriptableObjectExcel 配置表(导出为二进制或 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 有什么用?有什么坑? 作为独立的数据资源,用于配置、共享数据、事件通道。坑是编辑器中运行时的修改会被保存,打包后修改又不会保存,所以不要存放运行时状态。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Unity 资源目录与序列化:特殊文件夹、运行时路径、序列化规则、Prefab 与 ScriptableObject
https://xslab.cloud/posts/unity/basics/folders-and-serialization/
作者
LuxFire
发布于
2026-10-12
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
Unity 生命周期与时间:脚本执行顺序、Update 系列与 Time
Unity底层/基础 MonoBehaviour 各个事件函数的执行顺序与调用条件;Awake、OnEnable、Start 的区别,多个对象之间的执行顺序;FixedUpdate、Update、LateUpdate 各自适合做什么;Destroy 的延迟、移动端前后台切换;deltaTime、fixedDeltaTime、timeScale 等时间相关的值,以及帧率无关的写法。
2
Unity 动画系统:Animator 状态机、混合树、Root Motion、动画事件与性能
Unity底层/基础 Animation 与 Animator 的区别;Animator Controller 的状态、过渡、参数、Has Exit Time、动画层与遮罩;混合树;Humanoid 与 Generic、动画重定向;Root Motion;动画事件与 StateMachineBehaviour;Override Controller;以及 Animator 的性能问题与优化方案。
3
Unity 相机与 Layer:投影方式、清除、渲染顺序、相机堆叠与 Layer/Tag/Sorting Layer
Unity底层/基础 相机的透视与正交投影、清除方式、Culling Mask、多相机的渲染顺序、URP 相机堆叠、Viewport Rect 与 RenderTexture 的用途、屏幕与世界坐标转换;Layer、Tag、Sorting Layer 的区别与用途,LayerMask 的位运算,以及半透明物体的排序规则。
4
Unity 物理:Rigidbody、Collider、Trigger、射线检测与 CharacterController
Unity底层/基础 静态碰撞体、运动学刚体、动态刚体的区别与移动方式;碰撞与触发的区别,OnCollision 和 OnTrigger 的触发条件;碰撞矩阵;射线与形状检测;CharacterController 与 Rigidbody 角色的对比;高速物体穿透与连续碰撞检测;以及物理插值。
5
Unity 中的数学与 Transform:点乘叉乘、四元数、万向节锁与插值
Unity底层/基础 向量的长度与归一化;点乘与叉乘的几何意义和在游戏中的应用(前后、左右、夹角、视野判断);本地坐标与世界坐标的转换;欧拉角、万向节锁与四元数;四元数的乘法顺序与常用 API;Lerp、Slerp、MoveTowards、SmoothDamp 的区别。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
60
分类
6
标签
164
总字数
171,869
运行时长
0 天
最后活动
0 天前

文章目录