游戏引擎 / 系统课时

排查 Layout Rebuild 开销

排查 Layout Rebuild 开销

背包列表滚动或 HUD 数字变化时发生卡顿,可能是 uGUI 自动布局反复重算。本篇用 Unity 6 Profiler 区分布局与批次耗时,查出 Layout Group 的脏标记回溯,再通过按需刷新与简化层级验证效果。

学习目标

  • 在 UI 与 CPU Usage Profiler 中识别 Layout Rebuild 耗时。
  • 判断嵌套 Layout Group、文本与 Content Size Fitter 怎样扩大重算范围。
  • 通过一次可运行的 HUD 示例减少布局失效,并按相同条件复测。

在 Profiler 中找到布局尖峰

以下步骤适用于 Unity 6 的 uGUI(Unity UI),不是 UI Toolkit 的布局系统。先在目标设备的 Development Build 上复现;Editor 中的 Scene 视图与 Inspector 也可能干扰采样。

  1. 打开 Window > Analysis > Profiler,在模块菜单启用 UI 和 CPU Usage。
  2. 连续滚动背包列表或更新 HUD 约 20 秒,选中卡顿帧;在 UI 模块观察 Layout 时间是否同步抬升。
  3. 切到 CPU Usage > Timeline,展开主线程的 UI 更新区段,查看 Canvas.SendWillRenderCanvases、CanvasUpdate.Layout 等采样项;具体标记随 uGUI 包版本和采样模式有所不同。
  4. 记录相同交互下至少 200 帧的 Layout 时间及峰值,再记录不操作 UI 时的数据。

Layout 反映 Horizontal、Vertical、Grid Layout Group 等布局计算;Canvas.BuildBatch 一类批次构建耗时属于另一问题。只有 Layout 确认偏高,才优先改自动布局,不要仅凭 Draw Calls 多就拆布局层级。

追踪脏标记回溯与重算范围

当布局元素的首选尺寸、文本内容或 RectTransform 尺寸发生有效变化时,相关组件会请求布局更新。LayoutRebuilder.MarkLayoutForRebuild 会从受影响的节点向父级查找布局组,定位需要重建的布局根;嵌套组越多,查找组件和布局计算的潜在成本通常越高。

例如背包中一条物品名称位于 Vertical Layout Group 的行列表内,行内部又有 Horizontal Layout Group,外层还有自动计算尺寸的容器。名称由“药水”变为“超大型治疗药水”后,若需要重排,就可能牵动多层尺寸计算,而不只是改变一段文字的网格。

嵌套自动布局的脏标记回溯与布局重算范围

同一帧多次请求布局更新通常会进入待处理队列合并执行,并不等于每次调用都立即完整重算。不要在 Update() 里反复调用 LayoutRebuilder.ForceRebuildLayoutImmediate;它会绕开常规延迟重建时机,增加重复计算的风险。

用按需刷新消除无效改动

以 60 秒倒计时为例:如果界面只需要显示整数秒,就不应每帧把剩余时间格式化到两位小数并写入文本。在 Canvas 下创建一个带 Vertical Layout Group 的容器,再通过 GameObject > UI > Text - TextMeshPro 创建其文本子节点(部分版本菜单显示 TextMesh Pro - Text;首次使用先导入 TMP Essentials)。将脚本保存为 CountdownLabel.cs,挂到文本物体,并把 TMP_Text 拖入 Inspector 的 Label 字段。

csharp
using TMPro;
using UnityEngine;

public sealed class CountdownLabel : MonoBehaviour
{
    [SerializeField] private TMP_Text label;
    [SerializeField, Min(1)] private int durationSeconds = 60;

    private float endTime;
    private int lastShown = -1;

    private void Awake()
    {
        // 游戏暂停时 Time.time 停止推进,倒计时同步暂停。
        endTime = Time.time + durationSeconds;
    }

    private void Update()
    {
        int remaining = Mathf.Max(0, Mathf.CeilToInt(endTime - Time.time));
        // 只在屏幕显示值改变时更新文本,避免无意义的布局失效。
        if (remaining == lastShown) return;

        lastShown = remaining;
        label.text = $"{remaining}s";
    }
}

预期结果:初始显示 60s,随后按游戏时间逐秒变为 59s、58s,到 0s 后不再写入。暂停 Time.timeScale = 0 时倒计时也暂停。若需百分秒显示,这种降频不适用,应先确定业务允许的显示精度。

文本发生实际变化仍可能触发布局失效;这里减少的是变化次数。尤其对包含 Layout Group 的 HUD,刷新频率从接近每帧一次变为通常每秒一次,可以明显降低由此触发的重算频率,但最终耗时仍以 Profiler 为准。

缩小布局根并复测

对于固定四行的装备属性面板,可移除不必要的 Vertical Layout Group,改用左上锚点和相同 Pivot 的 RectTransform:每行高度 40 px、行距 8 px,四行的 Anchored Position Y 分别设为 0、-48、-96、-144。这种布局不依赖文字自动撑高,适合内容长度已受限制的固定槽位。

对必须随数量变化的背包列表,保留 Content 上的一层 Vertical Layout Group,例如 Spacing = 8、关闭 Child Force Expand Height,固定高度的子项用 Layout Element > Preferred Height = 40。若 ScrollRect 需要随内容调整总高度,可在 Content 上保留 Content Size Fitter > Vertical Fit = Preferred Size;不要再给受父布局控制的每个子项添加同方向的 Content Size Fitter,以免布局控制冲突。

复测时保持分辨率、可见物品数、滚动速度与设备相同,分别采样至少 200 帧,比较 UI > Layout 峰值和典型帧耗时,并检查文字换行、滚动范围及点击区域是否正确。若 Layout 已下降但长帧仍在,应回到 CPU Timeline 检查批次构建、文本生成或其他脚本,而不是继续盲目删除布局组件。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查 Layout Rebuild 开销

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

登录哪都通