1. 项目概述从“追踪”到“分析”的性能优化闭环在UE5项目开发的中后期性能优化是每个团队都必须啃下的硬骨头。你可能会发现明明在编辑器里跑得挺流畅的场景打包后却出现了卡顿或者一个看似简单的功能在特定设备上却成了性能瓶颈。这时候光靠感觉和经验去“猜”问题在哪效率极低且不准确。UE5为我们提供了一套强大的性能分析工具链其核心就是Unreal Insights。然而很多开发者初次接触时常常会被两个看似相似的概念搞糊涂追踪目录Trace Store Directory和分析目录Analysis Directory/Watched Folders。它们都跟性能数据文件.utrace有关但在整个性能分析工作流中扮演着截然不同的角色。理解它们的区别是高效利用Unreal Insights进行精准性能诊断的第一步。简单来说追踪目录是性能数据的“生产车间”和“主仓库”所有新录制的性能追踪文件默认都会存放在这里。而分析目录更像是性能数据的“阅览室”或“分拣站”你可以把其他地方的追踪文件比如从团队其他成员那里拷贝的或者从测试设备上导出的放在这里方便Unreal Insights统一浏览和加载分析。混淆两者可能会导致你找不到刚录制的数据或者无法便捷地对比历史数据。接下来我将结合自己多年的项目实战经验为你彻底拆解这两个目录的定位、配置方法以及如何围绕它们构建高效的团队协作流程。2. 核心概念拆解追踪目录与分析目录的本质区别要理解这两个目录我们必须先回顾一下Unreal Insights的基本工作流程。整个过程可以分为三个阶段数据录制Trace、数据存储Store和数据分析Insights。追踪目录和分析目录主要活跃在后两个阶段。2.1 追踪目录性能数据的原生家园追踪目录在Unreal Trace Server的配置中通常被称为“Trace Store Directory”。它是Unreal Trace Server的默认且主要的存储位置。它的核心职责是什么接收并持久化录制的数据当你启动一个性能追踪会话例如在编辑器里点击“Start Tracing”或通过命令行运行游戏并附加-tracedefault,frame参数时Unreal Trace Server会作为一个后台服务运行。它监听来自游戏或编辑器进程发送的性能事件流并将这些数据实时写入到追踪目录中生成.utrace主数据文件和.ucache缓存索引文件。作为数据管理的中心所有通过当前Trace Server录制的“第一手”数据都会存放在这里。你可以把它想象成相机的原始照片存储卡。所有新拍的照片性能数据都直接存进这张卡。它的关键特性唯一性一个正在运行的Unreal Trace Server实例有且只有一个活动的“Trace Store Directory”。它是数据写入的目标路径。默认路径通常位于用户的应用数据目录下例如Windows上是%LOCALAPPDATA%/UnrealEngine/Common/UnrealTrace。这个路径相对固定但可以更改。自动监视Unreal Insights界面中的“会话浏览器”会自动监视这个目录。任何在这个目录下新增或变化的.utrace文件都会立即出现在会话列表中方便你快速打开分析。实操心得很多新手遇到的一个典型问题是“我明明录了性能数据怎么在Unreal Insights里看不到” 十有八九是因为他们打开了另一个Unreal Insights实例而该实例连接的Trace Server的“追踪目录”并非数据实际保存的位置。确保你从录制数据的同一台机器、同一个用户会话下打开Unreal Insights通常就能在默认目录下找到数据。2.2 分析目录性能数据的聚合视图分析目录在Unreal Insights的界面中通常通过“添加目录”Add Directory或“监视文件夹”Watched Folders来管理。我更喜欢称它为“监视目录”。它的核心职责是什么聚合多来源数据你不可能所有的性能数据都只在默认目录下分析。你可能需要分析从其他同事那里共享过来的性能快照。从测试团队提供的打包版本中导出的追踪文件。你自己在不同日期、为不同分支录制的历史数据并统一存放在另一个项目文件夹里。提供统一浏览入口通过将这些分散在不同物理位置的文件夹添加到“分析目录”列表中Unreal Insights的会话浏览器就能同时扫描所有这些位置并将所有.utrace文件聚合显示在同一个列表中。这就像在你的照片管理软件里除了默认的“图片”库你还添加了“桌面\截图”、“D盘\项目素材”等文件夹这样你就能在一个界面里浏览所有照片而不用在各个文件夹之间来回切换。它的关键特性可添加多个你可以添加任意多个文件夹作为分析目录。只读浏览Unreal Insights不会向这些目录写入新的追踪文件。它们仅仅是用于“读取”和“发现”已有数据的源。颜色标识在Unreal Insights的会话浏览器中来自不同分析目录的文件会用不同颜色的图标进行区分让你一眼就能看出数据的来源。一个生动的类比想象你是一个侦探性能分析师。追踪目录是你的现场勘查记录本。每次出现新案件性能问题你都第一时间在这里记录所有线索性能数据。分析目录是你的案件档案柜。里面存放着过去所有案件的卷宗历史追踪文件也可能有从其他分局同事调来的相关案件资料。你把这个档案柜放在办公室方便随时查阅和对比不同案件。3. 配置与实操如何正确设置与管理目录理解了概念接下来就是动手配置。正确的配置能极大提升工作效率。3.1 配置追踪目录设置数据仓库追踪目录通常在首次使用或需要更改存储位置时进行设置。操作步骤打开Unreal Insights。这通常会同时启动Unreal Trace Server后台进程。在Unreal Insights主界面的左上角点击“菜单”按钮三条横线图标。选择“会话浏览器”打开会话浏览器窗口。在会话浏览器窗口的顶部找到并点击“管理存储设置”下拉按钮。点击“设置追踪存储目录”。此时会弹出一个文件夹选择对话框。为你新的性能数据选择一个理想的存储位置。我强烈建议选择一个空间充足、路径简单、易于备份的目录。例如你可以专门创建一个D:\UE5_PerformanceTraces\目录然后按项目或日期建立子文件夹。配置背后的逻辑与注意事项为什么更改默认目录默认的%LOCALAPPDATA%路径可能在C盘而性能追踪文件尤其是长时间录制或包含内存详细分配信息的体积可能非常大动辄几百MB甚至上GB。频繁录制容易挤满系统盘。更改的影响一旦你更改了“追踪目录”之前默认目录下的历史追踪文件将不会自动出现在新的会话浏览器列表中。为了解决这个问题Unreal Insights会很贴心地自动将旧的默认目录添加为一个“分析目录”。这样你既能把新数据存到新位置又不丢失对历史数据的访问。团队协作场景对于团队项目建议统一约定一个共享网络路径或版本控制下的特定目录作为“追踪目录”。但这需要更复杂的配置因为Trace Server通常运行在本地。更常见的做法是各自录制然后通过“分析目录”共享结果文件。3.2 配置分析目录构建数据看板分析目录的配置更加灵活旨在为你打造一个个性化的性能数据门户。操作步骤在Unreal Insights的“会话浏览器”中同样点击“管理存储设置”下拉按钮。点击“添加目录”按钮。浏览并选择你想要监视的文件夹。例如\\TeamServer\ProjectA\PerformanceSnapshots\团队共享目录D:\MyProject\Saved\Profiling\你本地项目的常用分析文件存放处C:\Users\TestTeam\Downloads\经常从测试设备下载追踪文件的目录高级用法与技巧按角色组织目录你可以为不同用途建立不同的分析目录。日常开发目录指向你当前活跃项目下的Saved/StoredTraces文件夹方便快速回顾今天做的几次优化对比。版本对比目录专门存放每个重要版本如V1.0, V1.1的“标准场景”性能基线文件。竞品分析目录存放你录制的其他游戏或Demo的性能数据如果支持。利用颜色标识添加目录后来自该目录的文件会有独特颜色。你可以形成自己的颜色习惯比如“绿色代表本地数据”、“蓝色代表服务器数据”、“红色代表性能回归数据”实现视觉化快速过滤。目录监视是实时的当你向一个已被监视的分析目录中拖入新的.utrace文件时Unreal Insights的会话列表几乎会立即刷新并显示该文件无需重启工具。踩坑记录有一次团队协作我配置了一个网络共享盘作为分析目录。发现文件列表刷新极慢甚至经常失败。原因是网络延迟和权限问题影响了Unreal Insights对文件夹的实时扫描。解决方案对于网络路径更可靠的做法是先将追踪文件下载到本地某个文件夹再将这个本地文件夹添加为分析目录。或者建立规范的命名规则将重要的性能快照文件通过版本控制或内部系统管理而不是依赖Unreal Insights直接监视网络路径。4. 实战工作流从录制到深度分析的完整路径现在我们将两个目录融入一个完整的性能分析工作流中。假设我们正在优化一个开放世界地图的运行时帧率。4.1 阶段一录制性能数据数据生产确定目标我们要分析玩家在特定区域骑行时的GPU瓶颈。启动追踪在编辑器中打开该地图点击底部状态栏的Trace按钮选择“Start Tracing”勾选gpu,frame,log等需要的通道。或者打包后的游戏通过命令行启动MyGame.exe -traceframe,gpu,statgpu -tracefileD:\Traces\RideArea_Perf.utrace。这里通过-tracefile参数直接指定了输出文件的完整路径和名称。这个文件最终会被保存在哪里呢它会被写入到当前运行的Unreal Trace Server所配置的“追踪目录”中。-tracefile参数只是指定了文件名而非绝对路径除非你写的是绝对路径但通常不推荐因为Trace Server可能会忽略路径部分只取文件名存入自己的存储目录。执行操作在游戏中操控角色骑行通过目标区域持续约30秒。停止追踪在编辑器点击停止或游戏正常退出。此时一个名为RideArea_Perf.utrace或你指定的名字的文件已经生成并位于Trace Server的追踪目录下。4.2 阶段二定位与加载数据数据访问打开Unreal Insights。查看会话浏览器你应该能在列表顶部看到刚刚录制的RideArea_Perf.utrace文件因为它就在当前Trace Server的追踪目录里。引入对比数据为了证明优化有效我需要和昨天的数据对比。昨天同事“小李”把他录制的基线文件RideArea_Baseline.utrace发到了团队共享盘Z:\Team\PerfTraces\。添加分析目录我将Z:\Team\PerfTraces\添加为分析目录。几秒钟后小李的文件也出现在了我的会话列表中并用另一种颜色图标标识。加载分析我双击打开我今天录制的文件进行分析。在分析过程中我可以随时从会话浏览器中再双击打开小李的基线文件。Unreal Insights会为每个.utrace文件打开一个独立的分析标签页我可以轻松地在两个标签页之间切换对比Timing Insights中的GPU线程时间线或者Memory Insights中的资产加载差异。4.3 阶段三基于目录管理的团队协作模式在多人团队中规范目录的使用能避免混乱。个人本地目录追踪目录每个开发者将自己的Trace Store Directory设置到本地空间较大的盘符例如E:\UE5_Traces\ProjectName\。这是每个人的“草稿本”。项目共享分析目录在版本控制如Perforce, Git LFS或共享存储中建立一个固定的文件夹结构例如//Depot/Project/Content/Performance/ ├── Baselines/ # 各版本性能基线 │ ├── Release_1.0/ │ └── Release_1.1/ ├── Investigations/ # 具体问题调查 │ ├── 2024-10_OpenWorld_Stutter/ │ └── 2024-11_Menu_Lag/ └── Weekly_Reports/ # 周度性能报告附件每个团队成员都将这个//Depot/Project/Content/Performance/映射到本地的P:\Project\Performance\并将其添加为Unreal Insights的分析目录。工作流程开发者在本地录制和分析数据。当发现一个确切的性能问题并录制了“问题”追踪文件后将其连同优化后的“对比”追踪文件一起提交到共享目录下对应的子文件夹中。在代码审查或问题讨论时直接引用共享目录中的文件路径。其他成员无需手动拷贝文件因为他们的Unreal Insights通过分析目录已经能看到这些文件。建立命名规范日期_场景_描述_版本.utrace例如20241115_OpenWorld_RideArea_BeforeOptimization.utrace。5. 常见问题排查与高级技巧即使理解了原理在实际操作中还是会遇到各种问题。下面是我总结的一些典型场景和解决方法。5.1 问题排查速查表问题现象可能原因解决方案录制的追踪文件在Unreal Insights里找不到1. Unreal Insights连接的不是录制时所用的Trace Server。2. 文件被保存到了其他位置而该位置未被添加为分析目录。1. 关闭所有Unreal Insights和编辑器重新启动编辑器并从其内部打开Unreal Insights这能确保连接到正确的Server。2. 去Trace Server的默认目录(%LOCALAPPDATA%/UnrealEngine/Common/UnrealTrace)或你自定义的追踪目录下寻找文件并将其所在文件夹添加为分析目录。从别人那里拷贝的.utrace文件无法打开1. 文件损坏或不完整。2. 追踪文件版本与当前Unreal Insights版本不兼容较罕见。3. 缺少对应的.ucache索引文件。1. 让对方重新录制并传输。2. 尽量使用相同版本的引擎进行分析。UE5的追踪格式兼容性较好但跨大版本如5.1到5.3可能有问题。3. 确保.utrace和.ucache文件在同一目录下且文件名相同扩展名不同。添加的网络分析目录刷新慢或失败网络延迟、权限不足或防火墙阻止。将文件先同步到本地目录再将本地目录添加为分析目录。对于团队协作建议使用版本控制工具同步追踪文件。Unreal Insights启动时报错或无法连接Trace Server端口冲突默认1981被占用或之前的Trace Server进程未正常退出。1. 在任务管理器中结束所有UnrealTraceServer.exe进程。2. 尝试以管理员身份运行Unreal Insights。3. 通过命令行UnrealTraceServer kill强制关闭服务器再重新启动。追踪文件体积过大录制几分钟就几个GB启用了过于详细或高频率的追踪通道如memory详细内存分配、counters高频计数器。根据分析目标精确选择通道。例如只分析GPU性能时用tracegpu,frame,statgpu即可避免开启memory或file。使用-tracefile指定输出文件名也便于管理。5.2 高级技巧与心得使用命令行参数进行精准控制-tracehost127.0.0.1:1981明确指定连接到的Trace Server地址和端口。-tracedefault,frame,gpu,statgpudefault通道包含CPU基础信息frame提供帧边界gpu和statgpu提供GPU时间线和统计信息。这是性能分析的黄金组合。-tracefileMyPerfSession指定生成的文件名避免使用自动生成的晦涩名称。注意文件最终仍存储在Trace Store Directory下但会以你指定的名字命名。自动化集成 在自动化测试流水线中可以在运行测试时自动启动追踪并将生成的.utrace文件作为产物保存。然后在后续的分析节点上可以配置一个固定的分析目录指向这些产物实现性能数据的自动收集和归档。“.ucache”文件的重要性 这个文件是索引文件能显著加快大型.utrace文件的加载速度。第一次加载一个追踪文件时Insights会生成.ucache。务必将它和.utrace文件一起拷贝和存储。如果丢失了Insights会重新生成但对于大文件这会非常耗时。内存分析的特殊性 使用memory通道进行深度内存分析时产生的数据量巨大。务必确保你的追踪目录所在磁盘有充足空间建议预留50GB以上。同时分析这类文件对系统内存RAM要求也较高16GB可能吃紧32GB或以上会更流畅。区分清楚追踪目录和分析目录本质上是在梳理性能数据的“生命周期”和“协作流”。追踪目录关乎数据的生产与存储是源头分析目录关乎数据的消费与聚合是门户。掌握它们你就能在UE5复杂的性能海洋中为自己建立起一个井然有序的数据港口让每一次性能调查都有的放矢让每一次优化对比都清晰可见。这不仅仅是两个文件夹路径的设置更是迈向专业化性能调优工作流的关键一步。 
长河君 · 2026/8/10 8:23:31 · 阅读 1.2k UE5性能分析：追踪目录与分析目录的核心区别与实战配置
1. 项目概述从“追踪”到“分析”的性能优化闭环在UE5项目开发的中后期性能优化是每个团队都必须啃下的硬骨头。你可能会发现明明在编辑器里跑得挺流畅的场景打包后却出现了卡顿或者一个看似简单的功能在特定设备上却成了性能瓶颈。这时候光靠感觉和经验去“猜”问题在哪效率极低且不准确。UE5为我们提供了一套强大的性能分析工具链其核心就是Unreal Insights。然而很多开发者初次接触时常常会被两个看似相似的概念搞糊涂追踪目录Trace Store Directory和分析目录Analysis Directory/Watched Folders。它们都跟性能数据文件.utrace有关但在整个性能分析工作流中扮演着截然不同的角色。理解它们的区别是高效利用Unreal Insights进行精准性能诊断的第一步。简单来说追踪目录是性能数据的“生产车间”和“主仓库”所有新录制的性能追踪文件默认都会存放在这里。而分析目录更像是性能数据的“阅览室”或“分拣站”你可以把其他地方的追踪文件比如从团队其他成员那里拷贝的或者从测试设备上导出的放在这里方便Unreal Insights统一浏览和加载分析。混淆两者可能会导致你找不到刚录制的数据或者无法便捷地对比历史数据。接下来我将结合自己多年的项目实战经验为你彻底拆解这两个目录的定位、配置方法以及如何围绕它们构建高效的团队协作流程。2. 核心概念拆解追踪目录与分析目录的本质区别要理解这两个目录我们必须先回顾一下Unreal Insights的基本工作流程。整个过程可以分为三个阶段数据录制Trace、数据存储Store和数据分析Insights。追踪目录和分析目录主要活跃在后两个阶段。2.1 追踪目录性能数据的原生家园追踪目录在Unreal Trace Server的配置中通常被称为“Trace Store Directory”。它是Unreal Trace Server的默认且主要的存储位置。它的核心职责是什么接收并持久化录制的数据当你启动一个性能追踪会话例如在编辑器里点击“Start Tracing”或通过命令行运行游戏并附加-tracedefault,frame参数时Unreal Trace Server会作为一个后台服务运行。它监听来自游戏或编辑器进程发送的性能事件流并将这些数据实时写入到追踪目录中生成.utrace主数据文件和.ucache缓存索引文件。作为数据管理的中心所有通过当前Trace Server录制的“第一手”数据都会存放在这里。你可以把它想象成相机的原始照片存储卡。所有新拍的照片性能数据都直接存进这张卡。它的关键特性唯一性一个正在运行的Unreal Trace Server实例有且只有一个活动的“Trace Store Directory”。它是数据写入的目标路径。默认路径通常位于用户的应用数据目录下例如Windows上是%LOCALAPPDATA%/UnrealEngine/Common/UnrealTrace。这个路径相对固定但可以更改。自动监视Unreal Insights界面中的“会话浏览器”会自动监视这个目录。任何在这个目录下新增或变化的.utrace文件都会立即出现在会话列表中方便你快速打开分析。实操心得很多新手遇到的一个典型问题是“我明明录了性能数据怎么在Unreal Insights里看不到” 十有八九是因为他们打开了另一个Unreal Insights实例而该实例连接的Trace Server的“追踪目录”并非数据实际保存的位置。确保你从录制数据的同一台机器、同一个用户会话下打开Unreal Insights通常就能在默认目录下找到数据。2.2 分析目录性能数据的聚合视图分析目录在Unreal Insights的界面中通常通过“添加目录”Add Directory或“监视文件夹”Watched Folders来管理。我更喜欢称它为“监视目录”。它的核心职责是什么聚合多来源数据你不可能所有的性能数据都只在默认目录下分析。你可能需要分析从其他同事那里共享过来的性能快照。从测试团队提供的打包版本中导出的追踪文件。你自己在不同日期、为不同分支录制的历史数据并统一存放在另一个项目文件夹里。提供统一浏览入口通过将这些分散在不同物理位置的文件夹添加到“分析目录”列表中Unreal Insights的会话浏览器就能同时扫描所有这些位置并将所有.utrace文件聚合显示在同一个列表中。这就像在你的照片管理软件里除了默认的“图片”库你还添加了“桌面\截图”、“D盘\项目素材”等文件夹这样你就能在一个界面里浏览所有照片而不用在各个文件夹之间来回切换。它的关键特性可添加多个你可以添加任意多个文件夹作为分析目录。只读浏览Unreal Insights不会向这些目录写入新的追踪文件。它们仅仅是用于“读取”和“发现”已有数据的源。颜色标识在Unreal Insights的会话浏览器中来自不同分析目录的文件会用不同颜色的图标进行区分让你一眼就能看出数据的来源。一个生动的类比想象你是一个侦探性能分析师。追踪目录是你的现场勘查记录本。每次出现新案件性能问题你都第一时间在这里记录所有线索性能数据。分析目录是你的案件档案柜。里面存放着过去所有案件的卷宗历史追踪文件也可能有从其他分局同事调来的相关案件资料。你把这个档案柜放在办公室方便随时查阅和对比不同案件。3. 配置与实操如何正确设置与管理目录理解了概念接下来就是动手配置。正确的配置能极大提升工作效率。3.1 配置追踪目录设置数据仓库追踪目录通常在首次使用或需要更改存储位置时进行设置。操作步骤打开Unreal Insights。这通常会同时启动Unreal Trace Server后台进程。在Unreal Insights主界面的左上角点击“菜单”按钮三条横线图标。选择“会话浏览器”打开会话浏览器窗口。在会话浏览器窗口的顶部找到并点击“管理存储设置”下拉按钮。点击“设置追踪存储目录”。此时会弹出一个文件夹选择对话框。为你新的性能数据选择一个理想的存储位置。我强烈建议选择一个空间充足、路径简单、易于备份的目录。例如你可以专门创建一个D:\UE5_PerformanceTraces\目录然后按项目或日期建立子文件夹。配置背后的逻辑与注意事项为什么更改默认目录默认的%LOCALAPPDATA%路径可能在C盘而性能追踪文件尤其是长时间录制或包含内存详细分配信息的体积可能非常大动辄几百MB甚至上GB。频繁录制容易挤满系统盘。更改的影响一旦你更改了“追踪目录”之前默认目录下的历史追踪文件将不会自动出现在新的会话浏览器列表中。为了解决这个问题Unreal Insights会很贴心地自动将旧的默认目录添加为一个“分析目录”。这样你既能把新数据存到新位置又不丢失对历史数据的访问。团队协作场景对于团队项目建议统一约定一个共享网络路径或版本控制下的特定目录作为“追踪目录”。但这需要更复杂的配置因为Trace Server通常运行在本地。更常见的做法是各自录制然后通过“分析目录”共享结果文件。3.2 配置分析目录构建数据看板分析目录的配置更加灵活旨在为你打造一个个性化的性能数据门户。操作步骤在Unreal Insights的“会话浏览器”中同样点击“管理存储设置”下拉按钮。点击“添加目录”按钮。浏览并选择你想要监视的文件夹。例如\\TeamServer\ProjectA\PerformanceSnapshots\团队共享目录D:\MyProject\Saved\Profiling\你本地项目的常用分析文件存放处C:\Users\TestTeam\Downloads\经常从测试设备下载追踪文件的目录高级用法与技巧按角色组织目录你可以为不同用途建立不同的分析目录。日常开发目录指向你当前活跃项目下的Saved/StoredTraces文件夹方便快速回顾今天做的几次优化对比。版本对比目录专门存放每个重要版本如V1.0, V1.1的“标准场景”性能基线文件。竞品分析目录存放你录制的其他游戏或Demo的性能数据如果支持。利用颜色标识添加目录后来自该目录的文件会有独特颜色。你可以形成自己的颜色习惯比如“绿色代表本地数据”、“蓝色代表服务器数据”、“红色代表性能回归数据”实现视觉化快速过滤。目录监视是实时的当你向一个已被监视的分析目录中拖入新的.utrace文件时Unreal Insights的会话列表几乎会立即刷新并显示该文件无需重启工具。踩坑记录有一次团队协作我配置了一个网络共享盘作为分析目录。发现文件列表刷新极慢甚至经常失败。原因是网络延迟和权限问题影响了Unreal Insights对文件夹的实时扫描。解决方案对于网络路径更可靠的做法是先将追踪文件下载到本地某个文件夹再将这个本地文件夹添加为分析目录。或者建立规范的命名规则将重要的性能快照文件通过版本控制或内部系统管理而不是依赖Unreal Insights直接监视网络路径。4. 实战工作流从录制到深度分析的完整路径现在我们将两个目录融入一个完整的性能分析工作流中。假设我们正在优化一个开放世界地图的运行时帧率。4.1 阶段一录制性能数据数据生产确定目标我们要分析玩家在特定区域骑行时的GPU瓶颈。启动追踪在编辑器中打开该地图点击底部状态栏的Trace按钮选择“Start Tracing”勾选gpu,frame,log等需要的通道。或者打包后的游戏通过命令行启动MyGame.exe -traceframe,gpu,statgpu -tracefileD:\Traces\RideArea_Perf.utrace。这里通过-tracefile参数直接指定了输出文件的完整路径和名称。这个文件最终会被保存在哪里呢它会被写入到当前运行的Unreal Trace Server所配置的“追踪目录”中。-tracefile参数只是指定了文件名而非绝对路径除非你写的是绝对路径但通常不推荐因为Trace Server可能会忽略路径部分只取文件名存入自己的存储目录。执行操作在游戏中操控角色骑行通过目标区域持续约30秒。停止追踪在编辑器点击停止或游戏正常退出。此时一个名为RideArea_Perf.utrace或你指定的名字的文件已经生成并位于Trace Server的追踪目录下。4.2 阶段二定位与加载数据数据访问打开Unreal Insights。查看会话浏览器你应该能在列表顶部看到刚刚录制的RideArea_Perf.utrace文件因为它就在当前Trace Server的追踪目录里。引入对比数据为了证明优化有效我需要和昨天的数据对比。昨天同事“小李”把他录制的基线文件RideArea_Baseline.utrace发到了团队共享盘Z:\Team\PerfTraces\。添加分析目录我将Z:\Team\PerfTraces\添加为分析目录。几秒钟后小李的文件也出现在了我的会话列表中并用另一种颜色图标标识。加载分析我双击打开我今天录制的文件进行分析。在分析过程中我可以随时从会话浏览器中再双击打开小李的基线文件。Unreal Insights会为每个.utrace文件打开一个独立的分析标签页我可以轻松地在两个标签页之间切换对比Timing Insights中的GPU线程时间线或者Memory Insights中的资产加载差异。4.3 阶段三基于目录管理的团队协作模式在多人团队中规范目录的使用能避免混乱。个人本地目录追踪目录每个开发者将自己的Trace Store Directory设置到本地空间较大的盘符例如E:\UE5_Traces\ProjectName\。这是每个人的“草稿本”。项目共享分析目录在版本控制如Perforce, Git LFS或共享存储中建立一个固定的文件夹结构例如//Depot/Project/Content/Performance/ ├── Baselines/ # 各版本性能基线 │ ├── Release_1.0/ │ └── Release_1.1/ ├── Investigations/ # 具体问题调查 │ ├── 2024-10_OpenWorld_Stutter/ │ └── 2024-11_Menu_Lag/ └── Weekly_Reports/ # 周度性能报告附件每个团队成员都将这个//Depot/Project/Content/Performance/映射到本地的P:\Project\Performance\并将其添加为Unreal Insights的分析目录。工作流程开发者在本地录制和分析数据。当发现一个确切的性能问题并录制了“问题”追踪文件后将其连同优化后的“对比”追踪文件一起提交到共享目录下对应的子文件夹中。在代码审查或问题讨论时直接引用共享目录中的文件路径。其他成员无需手动拷贝文件因为他们的Unreal Insights通过分析目录已经能看到这些文件。建立命名规范日期_场景_描述_版本.utrace例如20241115_OpenWorld_RideArea_BeforeOptimization.utrace。5. 常见问题排查与高级技巧即使理解了原理在实际操作中还是会遇到各种问题。下面是我总结的一些典型场景和解决方法。5.1 问题排查速查表问题现象可能原因解决方案录制的追踪文件在Unreal Insights里找不到1. Unreal Insights连接的不是录制时所用的Trace Server。2. 文件被保存到了其他位置而该位置未被添加为分析目录。1. 关闭所有Unreal Insights和编辑器重新启动编辑器并从其内部打开Unreal Insights这能确保连接到正确的Server。2. 去Trace Server的默认目录(%LOCALAPPDATA%/UnrealEngine/Common/UnrealTrace)或你自定义的追踪目录下寻找文件并将其所在文件夹添加为分析目录。从别人那里拷贝的.utrace文件无法打开1. 文件损坏或不完整。2. 追踪文件版本与当前Unreal Insights版本不兼容较罕见。3. 缺少对应的.ucache索引文件。1. 让对方重新录制并传输。2. 尽量使用相同版本的引擎进行分析。UE5的追踪格式兼容性较好但跨大版本如5.1到5.3可能有问题。3. 确保.utrace和.ucache文件在同一目录下且文件名相同扩展名不同。添加的网络分析目录刷新慢或失败网络延迟、权限不足或防火墙阻止。将文件先同步到本地目录再将本地目录添加为分析目录。对于团队协作建议使用版本控制工具同步追踪文件。Unreal Insights启动时报错或无法连接Trace Server端口冲突默认1981被占用或之前的Trace Server进程未正常退出。1. 在任务管理器中结束所有UnrealTraceServer.exe进程。2. 尝试以管理员身份运行Unreal Insights。3. 通过命令行UnrealTraceServer kill强制关闭服务器再重新启动。追踪文件体积过大录制几分钟就几个GB启用了过于详细或高频率的追踪通道如memory详细内存分配、counters高频计数器。根据分析目标精确选择通道。例如只分析GPU性能时用tracegpu,frame,statgpu即可避免开启memory或file。使用-tracefile指定输出文件名也便于管理。5.2 高级技巧与心得使用命令行参数进行精准控制-tracehost127.0.0.1:1981明确指定连接到的Trace Server地址和端口。-tracedefault,frame,gpu,statgpudefault通道包含CPU基础信息frame提供帧边界gpu和statgpu提供GPU时间线和统计信息。这是性能分析的黄金组合。-tracefileMyPerfSession指定生成的文件名避免使用自动生成的晦涩名称。注意文件最终仍存储在Trace Store Directory下但会以你指定的名字命名。自动化集成 在自动化测试流水线中可以在运行测试时自动启动追踪并将生成的.utrace文件作为产物保存。然后在后续的分析节点上可以配置一个固定的分析目录指向这些产物实现性能数据的自动收集和归档。“.ucache”文件的重要性 这个文件是索引文件能显著加快大型.utrace文件的加载速度。第一次加载一个追踪文件时Insights会生成.ucache。务必将它和.utrace文件一起拷贝和存储。如果丢失了Insights会重新生成但对于大文件这会非常耗时。内存分析的特殊性 使用memory通道进行深度内存分析时产生的数据量巨大。务必确保你的追踪目录所在磁盘有充足空间建议预留50GB以上。同时分析这类文件对系统内存RAM要求也较高16GB可能吃紧32GB或以上会更流畅。区分清楚追踪目录和分析目录本质上是在梳理性能数据的“生命周期”和“协作流”。追踪目录关乎数据的生产与存储是源头分析目录关乎数据的消费与聚合是门户。掌握它们你就能在UE5复杂的性能海洋中为自己建立起一个井然有序的数据港口让每一次性能调查都有的放矢让每一次优化对比都清晰可见。这不仅仅是两个文件夹路径的设置更是迈向专业化性能调优工作流的关键一步。