游戏引擎 / 系统课时

建立性能回归检查线

建立性能回归检查线

一次优化后的 Profiler 截图只能证明当时的表现,无法阻止后续资源或脚本改动再次拖慢游戏。本课把关键战斗场景的帧时、内存和加载时间变成明确预算,用固定流程采样,并让超标结果能够进入版本检查。

学习目标

  • 为同一硬件档位定义可复现的帧时、内存与加载预算。
  • 编写 Unity 场景采样脚本,输出统一的 PASS 或 FAIL 记录。
  • 区分测试环境波动和真实退化,并建立回归处理规则。

先固定场景与统计口径

准备一个只负责启动测试的 PerfBoot 场景,以及内容固定的 CombatBenchmark 战斗场景。将二者加入构建场景列表,确保目标场景名称唯一;从启动场景进入战斗场景,避免把手动点击和不一致的操作混入加载计时。

对同一硬件档位,先约定分辨率、画质、图形 API、垂直同步与目标帧率;战斗过程中敌人数量和行动路线也应固定。以下数值是演示预算,必须通过真实设备的基线数据再调整。

指标 测量口径 演示上限
帧时 P95 预热 30 帧后采样 240 帧,取第 95 百分位 16.7 ms
Unity 预留内存峰值 加载及运行期间采样的 TotalReservedMemory 最大值 512 MiB
场景加载耗时 发起 LoadSceneAsync 至加载完成 5000 ms

Time.unscaledDeltaTime 反映实际帧间隔,也会受到 VSync、帧率上限和测试环境影响,不能直接当作纯 CPU 或 GPU 耗时。Profiler.GetTotalReservedMemoryLong() 是 Unity 预留内存,不等于操作系统进程驻留内存,也不等于托管堆使用量。

用脚本输出三项验收结果

在 PerfBoot 场景中新建空对象,挂载下列 PerformanceGate.cs。它会保留自己跨场景运行,计时加载过程,跳过预热帧,然后取 240 帧的 P95 和采样到的内存峰值。

csharp
using System;
using System.Collections;
using System.Diagnostics;
using UnityEngine;
using UnityEngine.Profiling;
using UnityEngine.SceneManagement;

public sealed class PerformanceGate : MonoBehaviour
{
    private IEnumerator Start()
    {
        DontDestroyOnLoad(gameObject);

        // 场景加载从请求发出计时到 isDone
        var watch = Stopwatch.StartNew();
        AsyncOperation operation = SceneManager.LoadSceneAsync("CombatBenchmark");
        long peakReserved = Profiler.GetTotalReservedMemoryLong();

        while (!operation.isDone)
        {
            peakReserved = Math.Max(
                peakReserved, Profiler.GetTotalReservedMemoryLong());
            yield return null;
        }
        watch.Stop();

        for (int i = 0; i < 30; i++)
        {
            yield return null;
            peakReserved = Math.Max(
                peakReserved, Profiler.GetTotalReservedMemoryLong());
        }

        // 预热结束后采集连续帧,避免初始化阶段混入稳态帧时
        float[] frameMs = new float[240];
        for (int i = 0; i < frameMs.Length; i++)
        {
            yield return null;
            frameMs[i] = Time.unscaledDeltaTime * 1000f;
            peakReserved = Math.Max(
                peakReserved, Profiler.GetTotalReservedMemoryLong());
        }

        Array.Sort(frameMs);
        float p95 = frameMs[Mathf.CeilToInt(frameMs.Length * 0.95f) - 1];
        double reservedMiB = peakReserved / (1024.0 * 1024.0);

        // 内存接口返回 0 时视为无效采样,不允许误判通过
        bool pass = peakReserved > 0 &&
            p95 <= 16.7f &&
            watch.Elapsed.TotalMilliseconds <= 5000 &&
            reservedMiB <= 512;

        string message = $"PERF {(pass ? "PASS" : "FAIL")} " +
            $"load={watch.Elapsed.TotalMilliseconds:F0}ms " +
            $"p95={p95:F2}ms reserved={reservedMiB:F1}MiB";

        if (pass) UnityEngine.Debug.Log(message);
        else UnityEngine.Debug.LogError(message);
    }
}

预期输出(所有演示阈值都满足且内存值有效时):

text
PERF PASS load=<TIME>ms p95=<TIME>ms reserved=<MEMORY>MiB

任何一项超标则消息中的 PASS 变为 FAIL,并以错误日志输出。<TIME> 和 <MEMORY> 是每次运行变化的实测值,并非固定示例数字;目标场景若未加入构建场景列表,LoadSceneAsync 会报错,不能视为一次有效的性能测试。

把预算判断接入发布流程

采样结果必须有后续动作:通过才保留当前构建作为新的候选版本,失败就根据超标指标打开对应的 Profiler 证据。若没有产生完整的 PERF PASS/FAIL 日志,也应算测试失败,避免启动错误被误认为性能达标。

性能基线采集、预算判断与回归处理的检查流程

将设备型号、Unity 版本、构建编号、质量档位和每次三项实测值一起保存。持续集成可以启动目标构建并解析结果日志,但必须把 FAIL 或缺失结果转换为失败的任务状态;单纯打印错误日志并不会自动阻止发布。

排除假回归并建立复测规则

每个候选构建至少重复测量三次,保持录制路线、画质和后台负载一致。冷热加载应分开建基线;Profiler 深度采样只用于定位原因,正式过线以目标设备上的一致采样条件为准。

出现 P95 退化时,先检查 VSync、帧率上限和 CPU/GPU 时间;内存峰值异常时使用 Memory Profiler 快照追踪资源;加载变慢时拆查资源读取、反序列化、激活和初始化。当前脚本采到的是离散时刻的 Unity 预留内存,极短暂的尖峰可能被漏掉,必要时应结合平台内存工具复核。

回归线最有价值的地方不是一次 PASS,而是每次版本迭代都采用相同口径,保存可对照证据,并让真正超标的构建无法悄悄进入发布阶段。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立性能回归检查线

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

登录哪都通