游戏引擎 / 系统课时
追踪 GC.Alloc 的分配调用栈
追踪 GC.Alloc 的分配调用栈
卡顿帧中出现 GC.Alloc 时,单看分配字节数还无法知道是谁创建了临时对象。本篇以 Unity 6.3 LTS 为例,先复现每帧分配,再开启调用栈记录,在 CPU Usage 中追到具体的 C# 方法,最后验证取消重复分配后的变化。
学习目标
- 在 Profiler 中启用
GC.Alloc的Call Stacks并正确重新采样。 - 通过
Timeline、Hierarchy和Related Data找到分配来源。 - 区分托管分配与垃圾回收,并用同一场景复测修复效果。
构造可重复的分配样本
在 Unity 6.3 LTS 项目中创建 Assets/Scripts/GcAllocProbe.cs,把脚本挂到场景中的一个启用的 GameObject 上。示例刻意在 Update 中新建托管数组,便于观察;真实项目不应长期保留这种写法。
using Unity.Profiling;
using UnityEngine;
public sealed class GcAllocProbe : MonoBehaviour
{
private static readonly ProfilerMarker Marker =
new ProfilerMarker("GcAllocProbe.Update");
[SerializeField] private bool allocateEveryFrame = true;
private byte[] _buffer;
private void Awake()
{
// 修复模式下复用这块数组,避免 Update 中重复申请。
_buffer = new byte[1024];
}
private void Update()
{
using (Marker.Auto())
{
// 开关用于复现和对照,不是生产业务逻辑。
if (allocateEveryFrame)
_buffer = new byte[1024];
_buffer[0] = (byte)(Time.frameCount & 255);
}
}
}预期结果(在 Profiler 中观察,而非控制台输出):勾选 Inspector 的 Allocate Every Frame 后,GcAllocProbe.Update 每帧产生一次约 1 KB 的托管数组分配;实际 GC.Alloc 字节数还包含对象头与内存对齐开销。60 FPS 时仅数组元素的理论申请量就约为 60 KiB/s,具体帧率与样本值以实测为准。
开启 Call Stacks 并采集新帧
- 通过
Window > Analysis > Profiler打开窗口,将Target Selection设为Play Mode,选中CPU Usage。 - 在顶部工具栏启用
Call Stacks,确认其下拉选项包含已启用的GC.Alloc。保持Deep Profile关闭,以免全方法插桩干扰此次定位。 - 点击
Record开始录制,进入 Play Mode,运行约 3~5 秒;在 CPU Usage 曲线中点选这段时间内的任意一帧。 - 如果看到分配值却没有调用栈,先确认是开启
Call Stacks之后录到的帧。该选项不会给已有采样补回调用栈。
Call Stacks 可用于 Editor Play Mode 和已连接的开发版 Player,但采集调用栈会增加开销;它适合追踪来源,不适合直接作为最终帧耗时基线。
从 GC.Alloc 样本追到方法
在 CPU Usage 详情区切换到 Timeline,展开 Main Thread 和 GcAllocProbe.Update 所在的采样层级,放大并点击粉紫色的 GC.Alloc 样本。选中后的提示信息可显示分配大小及调用栈;使用 Copy 保存栈信息,必要时点击可用的蓝色代码路径打开 IDE。
若同时存在大量分配,改用 Hierarchy,点击 GC Alloc 列标题按分配字节数排序,展开高分配父节点直至具体的 GC.Alloc 采样。切换详情为 Related Data,选中代表单次分配的 N/A 条目,即可查看对应调用栈。Raw Hierarchy 适合避免同名采样合并后难以区分的问题。

注意:Hierarchy 中父节点的 GC Alloc 通常包含子节点的累计分配,不能把 PlayerLoop 之类的父采样直接判为创建对象的代码。调用栈里的文件链接也不保证精确指向 new 所在行,必要时要打开该方法逐句核对。
复用缓冲区并核对结果
- 先在勾选
Allocate Every Frame时选取 30 帧,记录GcAllocProbe.Update范围内的GC Alloc。 - 在运行中的 Inspector 取消该勾选,跳过切换当下的几帧,再选取相邻的稳定 30 帧。
Update此时只改写Awake中创建的数组,不再每帧new。 - 预期该自定义标记内部由数组造成的
GC.Alloc消失;整个帧的总分配可能仍大于零,因为其他脚本或 Editor 也会分配。 - 真正评估卡顿改善时,关闭
Call Stacks后在相同操作、相同目标设备上重新采样。需要确认设备性能时,优先使用目标平台的 Development Build,而不是直接拿 Editor Play Mode 帧时间当真机结果。
GC.Alloc 表示新发生的托管内存分配,不代表该帧已经执行垃圾回收;回收活动应另外观察 GC.Collect 等采样。优先修复游戏循环里持续出现、可避免的分配,再比较回收频率和帧时间,才能判断它是否真正导致卡顿。