AssetBundle 原理与打包策略:文件结构、压缩、加载、依赖与冗余

3753 字
19 分钟
AssetBundle 原理与打包策略:文件结构、压缩、加载、依赖与冗余

AssetBundle 在热更新中的使用,以及基于它的 YooAsset、Addressables,见 热更新;内存与卸载见 Unity 内存构成;加载策略见 资源加载与管理。本文讲 AssetBundle 本身的机制。

一、AssetBundle 是什么#

AssetBundle(下文简称 AB)是 Unity 的资源打包格式:把一组资源(Prefab、贴图、材质、音频、场景等)序列化成一个文件,运行时可以从本地或网络加载,再从中取出资源。

它解决的问题:

  • 资源可以不放在安装包里,按需下载,减小包体;
  • 资源可以热更新,不用重新发包;
  • 按需加载和卸载,控制内存。

AB 是平台相关的:为 Android 打的包不能在 iOS 上使用,每个平台要单独构建。

二、文件结构#

AssetBundle 文件
├── 文件头 格式标识、版本号、构建它的 Unity 版本、文件大小
├── 块信息与目录 数据被分成哪些块、每块如何压缩;包里有哪些文件(可能本身被压缩)
└── 数据块
├── 序列化文件(CAB-xxxx) 资源对象本身:GameObject、组件、材质参数等,以及类型信息(TypeTree)
├── .resS 文件 大块的原始数据:贴图像素、网格顶点等
└── .resource 文件 音频、视频数据

几个要点:

  • 序列化文件中保存的是对象的数据。对象之间的引用记录为”哪个文件中的第几个对象”,跨 AB 的引用就是这样指向另一个包的。
  • TypeTree 描述每种类型的字段结构,用于在不同 Unity 版本之间兼容地读取数据。可以通过构建选项不写入 TypeTree,让包更小、加载更快,但之后升级 Unity 版本时,旧的包可能无法读取,要谨慎使用。
  • 贴图、网格的原始数据放在 .resS 中,加载时可以直接从文件流式读取,不必全部先读进内存。

三、压缩方式#

LZMALZ4不压缩
构建选项默认(None)ChunkBasedCompressionUncompressedAssetBundle
压缩方式整个数据作为一个整体压缩按块(chunk)分别压缩不压缩
文件大小最小中等最大
加载时必须先解压整个包,才能读取其中任意资源只解压需要读取的那几块直接读取
加载速度慢快最快
内存解压时需要额外内存低低
适合网络传输本地存储、运行时加载对速度要求极高且不在乎大小

为什么 LZ4 可以只解压一部分:LZMA 把整个数据流作为一个整体压缩,要读其中某个位置,必须从头解压到那里。LZ4 是分块独立压缩的,读取某个资源时只需要找到它所在的块,单独解压这些块即可。

常见做法:下载用 LZMA,本地存 LZ4

  • 网络传输时,LZMA 体积小,下载快、省流量;
  • 下载完成后,在本地重新压缩为 LZ4(AssetBundle.RecompressAssetBundleAsync,或者使用 UnityWebRequestAssetBundle 配合 Unity 的缓存系统,它会自动转换),之后的每次加载都更快。

不想处理转换的项目,直接全部使用 LZ4 是最省心的选择,YooAsset 等框架默认也推荐 LZ4。

四、加载方式#

加载 AB 本身#

API说明内存与性能
AssetBundle.LoadFromFile(Async)从本地文件加载最推荐。对 LZ4 和不压缩的包,只读取文件头和目录,资源数据在需要时再从磁盘读取。LZMA 包会被完整解压到内存中
AssetBundle.LoadFromMemory(Async)从内存中的 byte[] 加载托管内存中的字节数组和 Unity 内部的副本同时存在,峰值内存约为包大小的两倍。仅在数据只能以字节数组形式拿到时使用
AssetBundle.LoadFromStream(Async)从自定义的 Stream 加载按需从流中读取,内存友好。适合加密的包:在 Stream 中边读边解密
UnityWebRequestAssetBundle.GetAssetBundle从网络下载并加载可以配合版本号或哈希使用 Unity 的缓存系统,下次直接从缓存加载

简单的加密:LoadFromFile(path, crc, offset) 支持跳过文件开头的若干字节。打包后在文件头部插入一段无用数据,可以让常见的解包工具无法直接识别;更强的加密需要用 LoadFromStream 配合自定义的解密流。YooAsset 的加密接口见 热更新。

从 AB 中加载资源#

var bundle = AssetBundle.LoadFromFile(path);
var prefab = bundle.LoadAsset<GameObject>("Hero"); // 按名字加载单个资源
var all = bundle.LoadAllAssets(); // 加载包中的所有资源
var sprites = bundle.LoadAssetWithSubAssets<Sprite>("Icons"); // 加载一张图集贴图中的所有 Sprite
// 场景包:加载 AB 后,直接用场景名加载场景
SceneManager.LoadSceneAsync("Level01");

都有对应的异步版本,游戏运行中应该使用异步版本(见 同步与异步)。

两个开销要分清#

1. 加载 AB: 打开文件、读取文件头和目录 → 内存中有一个 AssetBundle 对象
2. 加载资源: 从 AB 中反序列化具体的资源对象 → 内存中有了 Texture、GameObject 等
  • 只加载 AB 不加载资源,占用的内存很小(LZ4 时)。
  • bundle.Unload(false) 只释放第 1 部分,已经加载出来的资源仍然在内存中(见 Unload 的两个参数)。

五、依赖#

依赖是怎么产生的#

资源 A 引用了资源 B(比如 Prefab 引用了材质),而它们被打进了不同的包,A 所在的包就依赖 B 所在的包。

构建时 Unity 会生成一个总的 Manifest,记录每个包依赖了哪些包:

var manifestBundle = AssetBundle.LoadFromFile(Path.Combine(root, platformName));
var manifest = manifestBundle.LoadAsset<AssetBundleManifest>("AssetBundleManifest");
string[] deps = manifest.GetAllDependencies("ui/shop"); // 所有依赖,包括依赖的依赖

加载顺序#

从一个包中加载资源之前,它依赖的所有包都必须已经加载。 否则资源中引用的材质、贴图会丢失(显示为紫色或空白)。

至于这些包之间谁先加载,顺序无所谓,只要在加载资源之前都加载完即可。

卸载与引用计数#

一个公共的包(比如通用 UI 图集)会被很多包依赖。只有当所有依赖它的包都不再使用时,才能卸载它。这就需要给每个包维护引用计数:

加载 ui/shop: ui/shop +1,ui/common +1
加载 ui/bag: ui/bag +1,ui/common +1 ← ui/common 计数为 2
关闭商店: ui/shop -1 → 卸载;ui/common -1 → 还剩 1,不卸载
关闭背包: ui/bag -1 → 卸载;ui/common -1 → 0,卸载

这正是 YooAsset、Addressables 等框架帮我们做的事情。

循环依赖#

包 A 依赖包 B,包 B 又依赖包 A。Unity 允许这种情况,但会让引用计数和卸载变得复杂:两个包互相持有,计数永远不会归零。应该通过调整打包规则消除,通常是把双方共同引用的资源抽到一个公共包中。

六、打包策略#

打包粒度#

包太小(比如每个资源一个包)包太大(比如一个模块一个包)
问题包的数量多,每个包都有固定开销(文件句柄、文件头、目录、元数据),依赖关系复杂,加载时要打开很多文件用到其中一个资源,就要加载整个包;更新一个资源,整个包都要重新下载
卸载灵活包中只要有一个资源还在用,整个包都不能卸载

没有统一的标准,原则是:一起使用的资源打在一起,独立使用的资源分开。常见经验是单个包控制在几百 KB 到几 MB 之间,并结合实际的加载和更新情况调整。

常见的分包方式#

方式做法举例
按功能模块一个界面或一个系统一个包商店界面、背包界面各一个包
按场景 / 关卡关卡专用的资源打在一起第 1 关的地图、怪物
按类型某类全局共享的资源打在一起所有 Shader 一个包;字体一个包
按更新频率经常变化的资源和稳定的资源分开活动资源、配置表单独打包,更新时下载量小
公共资源单独打包被多个模块引用的资源抽出来通用按钮、通用图集、公共特效

冗余问题#

冗余的产生:一个资源被多个包中的资源引用,但它自己没有被指定打进任何一个包,Unity 会把它复制进每一个引用它的包。

商店 Prefab ──引用──▶ 通用按钮贴图(未指定包)
背包 Prefab ──引用──▶ 通用按钮贴图(未指定包)
结果:ui/shop 和 ui/bag 中各有一份按钮贴图

后果:

  • 包体变大;
  • 两个界面同时打开时,内存中有两份相同的贴图;
  • 两份贴图是两个不同的对象,不能合批。

解决:把被多个包引用的资源明确指定到一个公共包中。

检测:

  • 使用 YooAsset、Addressables 自带的构建报告和分析工具,它们会列出被重复打包的资源;
  • 自己写编辑器工具:遍历每个包包含的资源,用 AssetDatabase.GetDependencies 找出所有依赖,统计哪些未指定包的资源被不止一个包引用;
  • 用解包工具查看最终的包内容,确认是否有重复。

Shader 与变体#

  • 所有 Shader 打进一个包,游戏启动时加载,不卸载。Shader 被几乎所有材质引用,分散打包很容易造成冗余。
  • 变体问题:使用 shader_feature 声明的关键字,只会为打包时能找到的材质实际用到的组合生成变体。Shader 单独打包时,其他包中材质用到的组合可能没有被生成,运行时就会显示异常。常用的做法是创建一个 ShaderVariantCollection,把需要的变体显式收集进去,和 Shader 打在同一个包中。
  • 加载完成后可以用 ShaderVariantCollection.WarmUp 预热,避免首次使用时编译卡顿(见 资源加载与管理)。

图集#

  • 图集和它包含的 Sprite 应该打在同一个包中。如果 Sprite 分散在不同的包里,每个包都可能带上一份图集贴图,造成冗余。
  • 图集按界面或模块划分,避免一个界面只用了几个小图标,却要加载一整张大图集(见 Sprite Atlas)。

场景#

场景只能单独打包:一个场景包中只能包含场景,不能同时包含其他资源。场景中引用的资源可以单独打包,作为场景包的依赖。

七、构建#

两种构建管线#

内置管线可编程构建管线(SBP)
接口BuildPipeline.BuildAssetBundlesScriptable Build Pipeline 包
特点简单,可定制性低构建过程可定制,增量构建更快更可靠
使用者早期项目Addressables、YooAsset 都基于它

为什么资源没改,包的哈希却变了#

热更新依靠哈希判断包是否变化。如果哈希无故改变,玩家就会重复下载没有变化的包。常见原因:

  • 依赖的资源变了:一个材质改了,引用它的 Prefab 所在的包内容也可能变化。
  • Unity 版本变化:序列化格式、TypeTree 有差异。
  • Shader 编译结果变化:编译器版本、变体收集的结果不同。
  • 构建过程不确定:比如资源的顺序、某些编辑器中自动生成的数据每次不同。

应对:

  • 正式发布期间固定 Unity 版本和构建环境;
  • 使用 SBP 等更确定的构建流程;
  • 比较的是包的内容哈希,而不是文件的修改时间;
  • 发布前对比新旧清单,检查哪些包变化了,确认变化是否合理。

CRC 校验#

构建时会为每个包生成 CRC。下载后、加载时可以校验 CRC,发现文件损坏(下载不完整、被篡改)时删除重新下载。

八、常见问题#

现象可能的原因
资源显示为紫色材质的 Shader 丢失:Shader 所在的包没加载;或者变体缺失;或者包是用错误的平台构建的
贴图、材质丢失依赖的包没有在加载资源之前加载
内存中有两份同样的资源冗余打包;或者 Unload(false) 后再次加载了同一个包
正在显示的资源突然丢失调用了 Unload(true),或者依赖的包被提前卸载
报错”包已经加载”同一个包不能同时加载两次,需要先卸载,或者复用已经加载的实例
更新时下载量远大于改动量打包粒度太大,或者哈希无故变化

常见追问#

AssetBundle 的压缩方式有哪些?有什么区别? LZMA:整体压缩,体积最小,加载时必须整包解压,慢且耗内存。LZ4:分块压缩,加载时只解压需要的块,速度快、内存低。不压缩:最大但最快。常见做法是下载用 LZMA,本地转成 LZ4,或者直接全部用 LZ4。

LoadFromFile、LoadFromMemory、LoadFromStream 有什么区别? LoadFromFile 直接从文件读取,只读取需要的部分,最推荐;LoadFromMemory 需要先把整个包读进字节数组,内存中会同时存在两份;LoadFromStream 从自定义流中按需读取,适合边读边解密。

AB 的依赖怎么处理? 通过 Manifest 获取依赖列表,在从包中加载资源之前加载所有依赖的包。用引用计数管理,所有使用者都释放后才卸载被依赖的包。

什么是资源冗余?怎么解决? 被多个包引用、但没有指定打进任何包的资源,会被复制进每个引用它的包。导致包体变大、内存中存在多份、无法合批。解决办法是把公共资源指定到公共包中,并用分析工具检测。

AB 的打包粒度怎么把握? 包太小,数量多、固定开销大、依赖复杂;包太大,加载和更新都会带上不需要的资源。原则是一起使用的打在一起,按功能、场景、类型、更新频率划分,公共资源单独打包。

Shader 应该怎么打包? 所有 Shader 放在一个包里,启动时加载且不卸载;用 ShaderVariantCollection 收集需要的变体,避免变体缺失;加载后预热。

资源显示紫色是什么原因? Shader 丢失或变体缺失,或者使用了其他平台构建的包。

为什么资源没改,AB 的哈希也变了? 依赖资源变化、Unity 版本变化、Shader 编译结果变化、构建过程不确定等。要固定构建环境,使用更确定的构建管线,并在发布前对比清单。

Unload(true) 和 Unload(false) 的区别? false 只卸载包本身,已加载的资源保留,但再次加载同一个包会产生重复的资源;true 连同加载出来的资源一起卸载,正在使用的资源会丢失。项目中用引用计数管理,确认无人使用后再 Unload(true)。

文章分享

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

AssetBundle 原理与打包策略:文件结构、压缩、加载、依赖与冗余
https://xslab.cloud/posts/unity/assetbundle/
作者
LuxFire
发布于
2026-10-12
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
Unity 热更新:主流方案、原理设计与 HybridCLR + YooAsset 实践
项目设计/架构 为什么 Unity 需要专门的热更新方案;Lua、ILRuntime、PuerTS、HybridCLR 等代码热更方案的原理与对比;AssetBundle、Addressables、YooAsset 等资源热更方案;热更新的整体流程与架构设计;以及 HybridCLR 和 YooAsset 的原理、使用流程与注意事项。
2
资源加载与管理:同步异步、预加载、优先级与释放策略
项目设计/架构 资源加载为什么会卡顿、为什么会闪烁;一次加载经历的各个阶段及各自的开销;同步与异步加载的取舍;预加载的时机与策略;加载优先级、取消与过期回调;缓存分级与释放时机;分帧实例化与首帧卡顿;以及如何封装一层按"持有者"自动释放的加载接口。
3
Unity 内存构成:托管内存、原生内存与显存
Unity底层/资源与内存 一个 Unity 游戏的内存由哪几块组成、分别由谁分配和释放。重点讲 UnityEngine.Object 的"托管壳 + 原生本体"结构,以及资源卸载、显存估算和内存排查工具。
4
C# 与 Lua 交互原理:以 xLua 为例,Vector3 为什么能变快
Lua Lua 虚拟栈是 C# 与 Lua 交互的基础;C# 调用 Lua、Lua 调用 C# 时分别发生了什么;C# 对象如何以 userdata 的形式进入 Lua;反射与生成代码两种调用方式;交互的性能热点;xLua 的 GCOptimize 如何让 Vector3 等结构体零 GC 传递;以及减少交互开销的实践方法。
5
UGUI 原理与核心机制:Canvas、RectTransform、布局、事件与网格
Unity底层/UI UGUI 由哪些部分组成、一个 Image 是怎么画到屏幕上的;Canvas 的三种渲染模式与排序;RectTransform 的锚点、轴心、anchoredPosition 与 sizeDelta;布局系统的计算顺序;事件系统如何找到点击目标、事件如何冒泡;Graphic 与 VertexHelper 的网格生成;Image 类型、图集与 TextMeshPro;屏幕、UI、世界坐标的转换;以及 Button、Toggle、Slider、ScrollRect、InputField、Dropdown 等常用控件。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

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

文章目录