游戏引擎 / 系统课时
检查首包体积与资源冗余
检查首包体积与资源冗余
Unity 项目的首包突然增大时,不能只凭 Assets 文件夹大小判断原因。本课通过构建报告定位体积较大的资源,再检查场景、Resources 和 Addressables 的依赖关系,找出不必要的打包内容,并用相同构建条件验证优化效果。
学习目标
- 区分工程资源大小、构建输出大小和用户实际下载体积。
- 使用 Unity BuildReport 定位占用空间较大的打包资源。
- 识别重复依赖与多余资源,选择正确的优化方法并验证结果。
建立可比较的首包基线
首包是用户首次安装或启动游戏时必须获得的内容。它不一定等于整个项目资源目录,也不一定等于所有未来可下载内容的总和。
例如,Windows 桌面发布可能包含可执行文件、运行时组件和资源数据;Android 商店分发可能使用 AAB,并根据设备生成安装内容。远程 Addressables 资源则可能在首次运行之后单独下载。
因此,进行体积优化前,必须先固定统计口径。
| 统计对象 | 含义 | 注意事项 |
|---|---|---|
| Assets 目录 | 工程中的源资源 | 包含未引用资源,不等于发布体积 |
| BuildReport | 构建结果与打包资源信息 | 适合定位构建贡献来源 |
| 实际构建产物 | 平台输出文件 | 包含引擎、代码和资源等内容 |
| 用户下载包 | 分发平台实际提供的内容 | 可能经过压缩、拆分或设备定制 |
| 远程资源 | 首包之外的下载内容 | 需要单独衡量下载与缓存成本 |
建议首先完成一次正式构建,记录 Unity 版本、目标平台、构建配置、资源压缩策略、脚本裁剪设置、构建结果大小和资源下载方式。
后续每次优化都使用相同条件重新构建。不要把 Development Build 与正式发布版直接比较,也不要把未压缩目录大小与商店下载大小当作同一指标。
从 BuildReport 找出体积热点
Unity 的 BuildReport 能提供构建结果和打包资源信息。其中 summary.totalSize 是构建输出大小的统计值,packedAssets 包含资源在打包文件中的记录。
先通过 Unity 正常完成一次 Player 构建,再创建 Assets/Editor/BuildSizeAudit.cs。下面的脚本读取最近一次构建报告,按资源源路径汇总体积,并显示占用较大的十项资源。
using System;
using System.Linq;
using UnityEditor;
using UnityEditor.Build.Reporting;
using UnityEngine;
public static class BuildSizeAudit
{
[MenuItem("Tools/Build/Inspect Last Build Size")]
private static void Inspect()
{
var report = BuildReport.GetLatestReport();
// 只分析成功构建的报告,避免误读失败构建的数据。
if (report == null || report.summary.result != BuildResult.Succeeded)
{
Debug.LogWarning("No successful build report.");
return;
}
Debug.Log($"Build total: {report.summary.totalSize} bytes");
// 同一源资源可能出现在多个打包文件中,因此同时统计文件数量。
var largest = report.packedAssets
.SelectMany(pack => pack.contents.Select(asset => new
{
pack.shortPath,
asset.sourceAssetPath,
asset.packedSize
}))
.Where(item => !string.IsNullOrEmpty(item.sourceAssetPath))
.GroupBy(item => item.sourceAssetPath)
.Select(group => new
{
Path = group.Key,
Bytes = group.Sum(item => (decimal)item.packedSize),
PackedFiles = group.Select(item => item.shortPath).Distinct().Count()
})
.OrderByDescending(item => item.Bytes)
.Take(10);
foreach (var item in largest)
{
Debug.Log($"{item.Bytes} bytes | {item.PackedFiles} files | {item.Path}");
}
}
}在完成 Player 构建之后执行 Tools > Build > Inspect Last Build Size。
预期输出格式如下,实际字节数、打包文件数量和资源路径取决于工程内容:
Build total: <BYTES> bytes
<BYTES> bytes | <COUNT> files | Assets/<PATH>脚本最多输出十项资源。如果没有可分析的源资源条目,则只显示构建总大小。没有成功的最近构建报告时会输出:
No successful build report.GetLatestReport() 读取最近一次 Player 或 AssetBundle 构建报告,因此应先完成本次需要分析的 Player 构建,避免分析到其他构建任务的结果。
这里的资源体积是打包记录的汇总值,不能简单等同于压缩后安装包大小。一个资源出现在多个打包文件中也只能作为重复候选,不能据此直接认定存在可以安全删除的重复数据。
找出资源为什么被打进首包
大型资源是否需要优化,首先取决于它为什么进入构建产物。
通常需要检查三类来源:
- 场景依赖:构建场景直接或间接引用了资源,即使资源只被某个不常访问的对象使用,也可能进入内置场景数据。
- Resources 目录:资源被放入特殊的 Resources 目录后,可能作为内置资源纳入 Player 构建,即使当前代码没有实际加载它。
- Addressables 或 AssetBundle 依赖:资源可能被打入独立 Bundle;若多个 Bundle 隐式引用同一依赖,可能产生重复副本。
典型情况是两个 Addressables Group 分别包含不同的角色 Prefab,但两个角色引用同一材质。如果该材质未被明确作为共享 Addressable 依赖组织,打包系统可能把材质分别放进两个 Bundle。

如果项目安装了 Addressables,可通过对应版本提供的 Analyze 工具或 Build Layout 报告检查资源打包关系。部分版本提供 Check Duplicate Bundle Dependencies、Check Resources to Addressable Duplicate Dependencies 和 Check Scene to Addressable Duplicate Dependencies 等规则;实际入口和可用规则应以当前安装版本为准。
对于跨 Group 的共享资源,可以根据访问方式将其作为显式共享依赖组织;但这可能增加 Bundle 依赖和额外下载请求。若资源同时被内置场景直接引用和 Addressables 引用,还需要调整场景引用或加载方式,不能指望单纯移动 Group 自动解决所有重复问题。
按资源类型精准缩减体积
确认大资源的用途之后,再进行有针对性的调整。不同资源的主要成本来源并不相同。
| 资源类型 | 优先检查 | 处理方向 |
|---|---|---|
| Texture | 分辨率、格式、Mip Map | 使用适合目标平台的纹理压缩和尺寸 |
| AudioClip | 长度、声道、压缩格式 | 选择合适的压缩方式,移除无用音频 |
| Mesh | 顶点数量、附加数据 | 精简不需要的模型属性与细节 |
| Animation | 动画片段与导入设置 | 删除未使用片段,评估动画压缩 |
| Scene | 是否属于首次安装必需内容 | 排除测试场景,按需拆分内容 |
| Video | 编码格式与分辨率 | 压缩视频或按需下载 |
以纹理为例,在 Inspector 的 Texture Import Settings 中启用目标平台覆盖设置后,可以分别控制桌面和移动平台的最大尺寸与压缩格式。改变导入设置后必须重新构建,观察实际体积和画质变化。
对比优化前后结果并验收
体积优化需要同时满足资源完整、运行正常和交付大小下降三个条件。建议一次只修改一类资源或一组依赖,保证出现问题时能够定位具体原因。
可以按以下流程完成一次验收:
- 保存优化前的 BuildReport 和实际构建产物大小。
- 确认目标资源进入首包的依赖路径,记录修改原因。
- 修改资源导入设置、场景引用或 Addressables Group 布局。
- 在相同目标平台和构建选项下重新完成正式构建。
- 对比输出文件大小和打包资源条目,检查是否出现新的重复依赖。
- 在目标设备上测试资源加载、场景切换、声音播放和离线功能。
如果构建报告中的某张纹理体积下降,但最终下载包大小变化不明显,应进一步检查代码与引擎运行时开销、其他资源占比、压缩差异和平台封装方式。
如果把资源移到远程 Bundle 后首包明显变小,还应记录首次进入相关场景的额外下载量。首包缩减并不代表总下载成本一定下降。
可以使用以下记录格式比较同口径的构建结果:
| 指标 | 优化前 | 优化后 |
|---|---|---|
| 构建目标 | 相同平台 | 相同平台 |
| 构建模式 | Release | Release |
| 构建输出大小 | 实测记录 | 实测记录 |
| 最大资源体积 | 实测记录 | 实测记录 |
| 重复依赖候选 | 检查记录 | 复查记录 |
| 功能验证 | 通过 | 必须通过 |
真正有效的体积优化,是在不破坏游戏内容和资源加载行为的前提下,减少不必要的首次交付数据。坚持先通过报告定位,再依据依赖关系修改,最后用相同构建条件复测,才能确认优化是否具有实际价值。