游戏引擎 / 系统课时

Memory Profiler 抓取快照

Memory Profiler 抓取快照

本篇要在 Unity 6 的独立 Player 中,分别记录进入重资源场景前、加载完成后和退出场景后的内存状态。完成后你将得到三份可复查的快照,并能核对总占用、内存类别与对象数量,判断下一步该追查哪类资源。

学习目标

  • 安装 Memory Profiler,并让它连接目标设备上运行的 Development Player。
  • 在三个固定运行阶段抓取并保存 .snap 快照。
  • 通过 Summary、Unity Objects 和 All Of Memory 找到占用变化与常驻对象。

准备真实 Player 和分析工具

以下按 Unity 6.3 LTS(6000.3)与 Memory Profiler 1.1.x 说明;Unity 6.3 对应的正式包版本包括 1.1.12。它是单独的分析包,不是内置 Profiler 窗口中的 Memory 模块。

  1. 选择 Window > Package Management > Package Manager,切到 Unity Registry,搜索 Memory Profiler 并安装 1.1.x 正式版。
  2. 打开 File > Build Profiles,选择目标平台,启用 Development Build 与 Autoconnect Profiler;本次无需打开 Deep Profiling。
  3. 将待测场景加入构建场景列表,执行 Build and Run,在目标设备上启动 Player。确保 Editor 和设备能够通信。

采样环境要固定:同一设备、分辨率、画质、资源版本与启动方式。Editor 的 Play Mode 快照包含编辑器自身开销,不能直接代替设备端 Player 的内存基线。

在关键阶段抓取三份快照

打开 Window > Analysis > Memory Profiler。在窗口顶部 Attach to Player 下拉菜单里明确选中正在运行的目标 Player,不要选 Editor 或 Play Mode。

  1. 在 Capture 旁的 Capture Flags 中保留 Managed Objects、Native Objects、Native Allocations,以便同时检查托管对象、Unity 对象和原生分配;三次采集使用相同选项。
  2. 程序停在初始菜单,等待异步加载与过场结束后点击 Capture,在左侧 Snapshots 列表将这一份命名为 01-menu-idle。
  3. 进入重资源场景(例如战斗关卡),等模型、贴图及音频加载完成且画面稳定后再抓一次,命名为 02-battle-loaded。
  4. 返回初始菜单,等待场景卸载流程完成,再抓第三次,命名为 03-back-menu。

快照抓取会短暂停顿 Player,不适合在同一时刻用来判断帧耗时。快照通常保存在项目的 MemoryCaptures 目录中;列表里出现新记录后再打开分析。不要为了让数字好看而只在某一阶段手动执行 GC.Collect,否则三份结果失去可比性。

Memory Profiler 抓取 Player 快照与查看分类的界面位置

用脚本固定采样触发点

手动采集适合初次排查。若要在多次复现中准确触发采样,把下面的完整 Editor 脚本保存为 Assets/Editor/SnapshotCaptureMenu.cs。编译后在 Memory Profiler 中选中 Player,在对应场景阶段执行 Tools > Memory > Capture Current Target。

csharp
using System;
using System.IO;
using Unity.Profiling.Memory;
using UnityEditor;
using UnityEngine;

public static class SnapshotCaptureMenu
{
    [MenuItem("Tools/Memory/Capture Current Target")]
    private static void Capture()
    {
        // 每次使用不同文件名,避免覆盖上一次采样
        string folder = Path.Combine(Application.dataPath, "../MemoryCaptures");
        Directory.CreateDirectory(folder);
        string path = Path.Combine(folder, $"stage-{DateTime.UtcNow:yyyyMMdd-HHmmss}.snap");

        MemoryProfiler.TakeSnapshot(
            path,
            (resultPath, savedLocally) =>
            {
                // 连接 Player 时可能流式回传;回调不能代替文件验收
                Debug.Log("Snapshot callback finished; check Memory Profiler.");
            },
            CaptureFlags.ManagedObjects | CaptureFlags.NativeObjects | CaptureFlags.NativeAllocations);
    }
}

预期输出(Unity Console):

text
Snapshot callback finished; check Memory Profiler.

日志表示回调结束,不单独证明采集成功。连接 Player 时快照可能直接传回 Editor,此时回调中的 savedLocally 即使为 false 也不能当成整个采集失败;应检查 Snapshots 列表是否新增快照并能打开。

读取总量、分类和对象数量

在左侧单击 02-battle-loaded 打开单快照,从以下三个页面逐层核对,而不是把不同含义的内存数字简单相加。

  1. Summary:查看 Total Committed Memory 的总量和分布、Managed Memory 的托管堆情况,以及 Top Unity Objects Categories 中的占用大类。
  2. All Of Memory:展开 Scripting Memory、Native Memory、Graphics Memory 等项,区分对象占用、预留内存及图形相关分配。
  3. Unity Objects:按 Total Size 排序,展开 Texture2D、Mesh、AudioClip 等类型分组,检查各类对象数量、单个实例及其 Native/Managed Size;点选异常实例后利用 References 和 Selection Details 继续查看引用。

例如下面是假设数据,用于演示记录方式,不能当作设备性能标准:

采样阶段 Total Committed Memory Texture2D 对象数
菜单稳定 420 MiB 120
战斗场景稳定 680 MiB 240
返回菜单稳定 510 MiB 145

这组数据说明退出后仍比初始多 90 MiB、25 个纹理对象,但不能直接推断内存泄漏。要进一步看这些纹理是否仍有合理引用,并区分常驻缓存、内存池预留与未释放资源。需要逐项对比时,可以切换 Compare Snapshots,选择首次和退出后的快照。

排除最常见的采样误判

如果 Attach to Player 只出现 Editor,先确认实际运行的是 Development Build、设备连接正常,以及 Autoconnect Profiler 已启用。切勿将“采到了快照”和“采到了目标 Player”混为一谈。

若快照打开后数值不稳定,回到同一个触发条件重复采集:异步资源加载未结束、不同画质档位、首次着色器加载或额外的垃圾回收都会影响对照。对持续增长的怀疑,至少重复一次“进入场景—退出场景”循环,并核对同类对象及其引用是否持续增加。

最终保留三份可打开的 .snap,并记录 平台、Unity 版本、场景状态、采样时间和 Capture Flags。这样下一次比较才能定位资源常驻,而不是比较两种不同的运行环境。

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

目录与阅读设置

阅读设置

17

记录一个想法

Memory Profiler 抓取快照

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

登录哪都通