游戏引擎 / 系统课时
建立性能回归检查线
建立性能回归检查线
一次优化后的 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 和采样到的内存峰值。
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);
}
}预期输出(所有演示阈值都满足且内存值有效时):
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,而是每次版本迭代都采用相同口径,保存可对照证据,并让真正超标的构建无法悄悄进入发布阶段。