游戏引擎 / 系统课时

沿 Timeline 追踪主线程长帧

沿 Timeline 追踪主线程长帧

CPU Usage 曲线出现尖峰后,仅凭帧时间无法判断是哪段逻辑拖慢了游戏。本篇使用 Unity 6 Profiler 的 Timeline 视图,从异常帧进入 Main Thread,逐层追踪耗时样本,区分实际执行与线程等待,最终锁定长帧发生的位置并留下可复核的证据。

学习目标

  • 从 CPU Usage 曲线选择异常帧,在 Timeline 中定位 Main Thread 的长时间样本。
  • 理解父子样本的嵌套关系,区分脚本执行、垃圾回收和线程等待。
  • 使用自定义 ProfilerMarker 复现长帧,验证从帧尖峰到具体代码区域的定位过程。

从 CPU Usage 尖峰进入 Timeline

以下操作适用于 Unity 6.0~6.3 的 Profiler。先在编辑器 Play Mode 中练习操作,正式性能判断应优先使用目标设备上的 Development Build 采样,以减少编辑器自身负载的干扰。

  1. 打开 Window > Analysis > Profiler。
  2. 在 Profiler 顶部选择目标:本地练习使用 Play Mode,真机分析选择已连接的 Development Player。
  3. 选择 CPU Usage 模块,保持 Deep Profile 关闭,避免额外插桩明显改变耗时。
  4. 点击 Record 开始采样,运行目标场景,完成预热后重复容易卡顿的操作。
  5. 在上方 CPU Usage 曲线找到明显高于相邻帧的尖峰,单击对应帧。
  6. 停止录制以固定当前采样数据,在下方详情面板的视图下拉菜单中选择 Timeline。

例如目标为 60 FPS,单帧预算约为 16.67 ms。如果大多数帧接近 12 ms,某一帧突然达到 48 ms,就应优先检查这个异常帧,而不是从正常帧中寻找最耗时的函数。

沿 Main Thread 展开耗时样本

Timeline 将不同线程放在同一条时间坐标轴上。一个样本条块的水平长度代表持续时间,纵向嵌套表示采样区域之间的包含关系。同一段时间内,父级和子级样本可能同时覆盖相同的时间范围。

  1. 在 Timeline 左侧找到 Main Thread,展开线程组。
  2. 将鼠标移动到主线程长条附近,使用滚轮放大时间轴;按 A 可以恢复整帧视野。
  3. 展开线程的显示深度,观察 PlayerLoop 内部哪些区域占用了大部分时间。
  4. 单击最长的可疑子样本,使用 F 聚焦,并阅读样本工具提示中的名称和持续时间。
  5. 沿嵌套关系继续检查更深一层的样本,直到找到具体系统、自定义标记或无法继续细分的位置。

Unity 6 Profiler Timeline 中从 CPU 尖峰追踪主线程耗时样本的操作示意

假设一次采样得到以下数据:

样本 示例持续时间 关系
PlayerLoop 45 ms 主线程上的父级样本
Update.ScriptRunBehaviourUpdate 42 ms 位于 PlayerLoop 内部
Demo.MainThreadSpike 40 ms 位于脚本更新区域内部

这里不能计算成 45 + 42 + 40 = 127 ms,因为子样本的时间已经包含在父样本中。真正需要关注的是最深层约 40 ms 的区域,以及它为何发生。

如果需要查看聚合后的函数耗时,可以切换到 Hierarchy,通过 Time ms、Self ms 和 Calls 分析。Time ms 包括子样本耗时,Self ms 排除子样本耗时。Timeline 更适合回答“长时间发生在帧内的哪里”,Hierarchy 更适合回答“哪些样本累计耗时最多”。

区分执行耗时与线程等待

Main Thread 上最长的条块不一定意味着主线程正在进行大量计算。某些样本表示线程暂停,等待渲染、任务完成或帧率同步。

常见样本 表示什么 下一步检查
自定义脚本标记 标记区域内的代码耗时 检查区域内的循环、同步调用和数据处理
GC.Collect 托管垃圾回收 检查分配峰值与 GC 触发频率
WaitForJobGroupID 主线程等待作业完成 对齐 Job Worker 的任务执行时间
Gfx.WaitForPresentOnGfxThread 等待图形呈现相关工作 联合 Render Thread 和 GPU 数据分析
WaitForTargetFPS 等待目标帧率或同步时机 检查帧率限制和 VSync 设置

例如某帧持续 35 ms,其中 22 ms 落在 WaitForJobGroupID。这表明主线程正在等待作业完成,不能直接将这 22 ms 归因于调用等待操作的脚本计算。应该沿同一时间轴检查 Job Worker 是否有持续较长的任务,并确认任务是否阻塞主线程后续执行。

同样,如果最长的样本是 Gfx.WaitForPresentOnGfxThread,就要检查图形流水线是否形成阻塞。等待样本本身不是需要直接删除的代码,盲目优化主线程上其他短小函数往往不会改善这类长帧。

用自定义标记复现一次主线程长帧

为了验证定位步骤,可以在一个测试场景中主动制造可识别的主线程停顿,再使用 Timeline 查找它。以下示例适用于 Unity 6,使用 Unity.Profiling.ProfilerMarker 标记代码区域,不需要启用 Deep Profile。

在 Assets/Scripts 下创建 MainThreadSpikeDemo.cs,输入完整脚本:

csharp
using System.Threading;
using Unity.Profiling;
using UnityEngine;

public sealed class MainThreadSpikeDemo : MonoBehaviour
{
    private static readonly ProfilerMarker SpikeMarker =
        new ProfilerMarker("Demo.MainThreadSpike");

    private void Update()
    {
        // 每 120 帧制造一次停顿,方便在 CPU 时间线中定位。
        if (Time.frameCount % 120 != 0)
            return;

        // Auto 在离开作用域时结束采样,避免标记未闭合。
        using (SpikeMarker.Auto())
        {
            Thread.Sleep(40);
        }
    }
}

预期结果:将脚本挂到场景中一个激活的 GameObject,进入 Play Mode 并录制至少 240 帧后,CPU Usage 曲线应周期性出现尖峰。选中对应异常帧,在 Main Thread 的脚本更新区域下,可以找到名为 Demo.MainThreadSpike 的样本,持续时间通常约为 40 ms,实际数值受操作系统线程调度影响。

Thread.Sleep(40) 会主动阻塞当前线程,目的是制造教学用的可复现长帧,不代表 CPU 连续计算了 40 ms,也不是性能优化手段。真实项目中的计算热点应使用实际代码和同样的 ProfilerMarker 方法测量。

完成演示后按以下顺序复核:

  1. 选中尖峰帧,确认样本位于 Main Thread,不是其他工作线程。
  2. 聚焦 Demo.MainThreadSpike,检查它的持续时间和父级路径。
  3. 切换到相邻正常帧,确认该样本不存在或不再构成长时间停顿。
  4. 禁用 MainThreadSpikeDemo 组件,重新采样,确认人为制造的周期性尖峰消失。

如果 Timeline 中看不到自定义标记,先检查脚本是否真正执行、Profiler 是否连接到正确目标,以及对应帧是否仍在采样缓冲区内。自定义标记主要用于编辑器和 Development Build 分析。

保存能够指向问题位置的证据

排查记录至少应包含目标平台、复现操作、异常帧号、样本完整路径、样本持续时间,以及相邻正常帧的对照数据。

例如测试记录可以写成:Windows Development Player,目标 60 FPS;执行场景交互后,异常帧为 48 ms;Main Thread 中的 Demo.MainThreadSpike 持续约 40 ms,位于脚本更新区域;禁用对应组件后,重复操作不再出现同类尖峰。这里的数值属于演示案例,实际项目应填写采样所得的数据。

如果一个长样本始终只有引擎级父标记、缺少更细的可识别区域,应先在相关业务代码增加 ProfilerMarker,重新录制,再深入定位。避免仅凭 PlayerLoop 或 Scripts 这样的大范围样本就判断具体根因。

当异常帧、Main Thread 的长样本、具体代码区域以及复测结果能够对应起来时,才算完成了这一次长帧定位。后续优化应针对已确认的耗时来源展开,并使用相同场景和采样条件验证改善幅度。

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

目录与阅读设置

阅读设置

17

记录一个想法

沿 Timeline 追踪主线程长帧

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

登录哪都通