游戏引擎 / 系统课时

追踪 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 中新建托管数组,便于观察;真实项目不应长期保留这种写法。

csharp
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 并采集新帧

  1. 通过 Window > Analysis > Profiler 打开窗口,将 Target Selection 设为 Play Mode,选中 CPU Usage。
  2. 在顶部工具栏启用 Call Stacks,确认其下拉选项包含已启用的 GC.Alloc。保持 Deep Profile 关闭,以免全方法插桩干扰此次定位。
  3. 点击 Record 开始录制,进入 Play Mode,运行约 3~5 秒;在 CPU Usage 曲线中点选这段时间内的任意一帧。
  4. 如果看到分配值却没有调用栈,先确认是开启 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 适合避免同名采样合并后难以区分的问题。

Unity CPU Usage 中 GC.Alloc 与调用栈的定位路径

注意:Hierarchy 中父节点的 GC Alloc 通常包含子节点的累计分配,不能把 PlayerLoop 之类的父采样直接判为创建对象的代码。调用栈里的文件链接也不保证精确指向 new 所在行,必要时要打开该方法逐句核对。

复用缓冲区并核对结果

  1. 先在勾选 Allocate Every Frame 时选取 30 帧,记录 GcAllocProbe.Update 范围内的 GC Alloc。
  2. 在运行中的 Inspector 取消该勾选,跳过切换当下的几帧,再选取相邻的稳定 30 帧。Update 此时只改写 Awake 中创建的数组,不再每帧 new。
  3. 预期该自定义标记内部由数组造成的 GC.Alloc 消失;整个帧的总分配可能仍大于零,因为其他脚本或 Editor 也会分配。
  4. 真正评估卡顿改善时,关闭 Call Stacks 后在相同操作、相同目标设备上重新采样。需要确认设备性能时,优先使用目标平台的 Development Build,而不是直接拿 Editor Play Mode 帧时间当真机结果。

GC.Alloc 表示新发生的托管内存分配,不代表该帧已经执行垃圾回收;回收活动应另外观察 GC.Collect 等采样。优先修复游戏循环里持续出现、可避免的分配,再比较回收频率和帧时间,才能判断它是否真正导致卡顿。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

追踪 GC.Alloc 的分配调用栈

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通