游戏引擎 / 系统课时
沿 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 采样,以减少编辑器自身负载的干扰。
- 打开
Window > Analysis > Profiler。 - 在 Profiler 顶部选择目标:本地练习使用
Play Mode,真机分析选择已连接的 Development Player。 - 选择
CPU Usage模块,保持Deep Profile关闭,避免额外插桩明显改变耗时。 - 点击
Record开始采样,运行目标场景,完成预热后重复容易卡顿的操作。 - 在上方 CPU Usage 曲线找到明显高于相邻帧的尖峰,单击对应帧。
- 停止录制以固定当前采样数据,在下方详情面板的视图下拉菜单中选择
Timeline。
例如目标为 60 FPS,单帧预算约为 16.67 ms。如果大多数帧接近 12 ms,某一帧突然达到 48 ms,就应优先检查这个异常帧,而不是从正常帧中寻找最耗时的函数。
沿 Main Thread 展开耗时样本
Timeline 将不同线程放在同一条时间坐标轴上。一个样本条块的水平长度代表持续时间,纵向嵌套表示采样区域之间的包含关系。同一段时间内,父级和子级样本可能同时覆盖相同的时间范围。
- 在 Timeline 左侧找到
Main Thread,展开线程组。 - 将鼠标移动到主线程长条附近,使用滚轮放大时间轴;按
A可以恢复整帧视野。 - 展开线程的显示深度,观察
PlayerLoop内部哪些区域占用了大部分时间。 - 单击最长的可疑子样本,使用
F聚焦,并阅读样本工具提示中的名称和持续时间。 - 沿嵌套关系继续检查更深一层的样本,直到找到具体系统、自定义标记或无法继续细分的位置。

假设一次采样得到以下数据:
| 样本 | 示例持续时间 | 关系 |
|---|---|---|
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,输入完整脚本:
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 方法测量。
完成演示后按以下顺序复核:
- 选中尖峰帧,确认样本位于
Main Thread,不是其他工作线程。 - 聚焦
Demo.MainThreadSpike,检查它的持续时间和父级路径。 - 切换到相邻正常帧,确认该样本不存在或不再构成长时间停顿。
- 禁用
MainThreadSpikeDemo组件,重新采样,确认人为制造的周期性尖峰消失。
如果 Timeline 中看不到自定义标记,先检查脚本是否真正执行、Profiler 是否连接到正确目标,以及对应帧是否仍在采样缓冲区内。自定义标记主要用于编辑器和 Development Build 分析。
保存能够指向问题位置的证据
排查记录至少应包含目标平台、复现操作、异常帧号、样本完整路径、样本持续时间,以及相邻正常帧的对照数据。
例如测试记录可以写成:Windows Development Player,目标 60 FPS;执行场景交互后,异常帧为 48 ms;Main Thread 中的 Demo.MainThreadSpike 持续约 40 ms,位于脚本更新区域;禁用对应组件后,重复操作不再出现同类尖峰。这里的数值属于演示案例,实际项目应填写采样所得的数据。
如果一个长样本始终只有引擎级父标记、缺少更细的可识别区域,应先在相关业务代码增加 ProfilerMarker,重新录制,再深入定位。避免仅凭 PlayerLoop 或 Scripts 这样的大范围样本就判断具体根因。
当异常帧、Main Thread 的长样本、具体代码区域以及复测结果能够对应起来时,才算完成了这一次长帧定位。后续优化应针对已确认的耗时来源展开,并使用相同场景和采样条件验证改善幅度。