排障与运维指南

指南 01

开启 Lumen 与 Nanite 时编辑器帧率偏低

视口卡顿常因迭代时仍开启高质量光照与密集 Nanite 场景。请先降低编辑器路径质量；出货画质留给打包配置文件。

1. 1

   确认瓶颈

   按下 Ctrl+Shift+,（或用 ~ 打开控制台），查看 stat unit / stat gpu。记录是 Game、Draw 还是 GPU 占主导。

2. 2

   编辑时降低视口可扩展性

   使用视口 Scalability 快捷方式（或编辑器偏好设置），将预览设为 Medium 或 Low。避免在笔记本 GPU 上以 Epic 画质与接近光追观感的 Lumen 设置进行编辑。

3. 3

   为编辑器调优 Lumen

   在项目设置中搜索 Lumen。若硬件光追不稳定，日常工作优先使用 Software Ray Tracing。必要时仅对编辑器路径降低 Final Gather 质量与反射分辨率。

4. 4

   控制 Nanite 开销

   隐藏未用 Nanite 图层，使用关卡或 World Partition 加载范围，避免在同一视口打开全部高模集。临时线框或无光照视图有助于隔离网格密度问题。

5. 5

   使用干净的 Derived Data Cache 路径重启

   若插件或引擎升级后卡顿加剧，请清理或将 DDC 迁到快速本地 SSD。网络 DDC 停顿即使在 GPU 负载不高时也会像「引擎卡顿」。

指南 02

打包失败与 Output Log 排查

多数打包失败来自缺少模块、平台 SDK 不匹配，或已在 Output Log 更早位置出现的 cook 错误。请读第一条红色错误，而不只看最后一行。

1. 1

   使平台 SDK 与引擎版本匹配

   打包 Windows 时，确认您的 UE 版本所列 Visual Studio 工作负载与 Windows SDK 版本。Android/iOS 请安装发行说明中点名的精确 NDK/Xcode 组合。

2. 2

   先 cook Development 构建

   先打包 Development，再打 Shipping。Shipping 会剥离断言，可能掩盖真正的 cook 失败。确认关卡已列入 项目设置 → Packaging → Maps to cook。

3. 3

   禁用未用插件

   无法加载的第三方插件即使编辑器能打开，也常会阻断打包。关闭不准备出货的插件；若为 C++ 项目，再重新生成项目文件。

4. 4

   修复软引用与缺失资产

   在日志中搜索 “Failed to load” 与 “Couldn’t find file”。移动后残留的 Redirector 常导致 cook 中断。在编辑器中重新保存问题资产。

5. 5

   卡住时清理 Intermediate 与 Saved

   关闭编辑器，删除项目 Intermediate 以及（谨慎地）Saved/Cooked 文件夹，再重新打开并打包。若自定义过 ini，请备份 Config。

指南 03

磁盘空间与启动器组件下载

Epic Games Launcher 按需拉取引擎组件。没有单一固定安装包体积。请为引擎、DDC 与临时下载缓存规划可用空间。

1. 1

   安装前选定驱动器

   在启动器中，将 Unreal Engine 安装位置设到有余量的驱动器。事后换盘意味着已选组件需再次完整下载。

2. 2

   只安装所需目标平台

   在确有需要前可跳过 Android、iOS、Linux 或 Starter Content。每个目标平台都会增加大量组件数据。

3. 3

   留意下载缓存

   若安装中途因「空间不足」失败，请清理启动器下载缓存并清空回收站 / 废纸篓。临时归档可能短暂使磁盘占用翻倍。

4. 4

   清理旧引擎版本

   删除不再打开的引擎。仅当仍有在线项目因二进制兼容需要时，才保留一个旧版本。

存储估算与平台按钮见下载页。

指南 04

引擎工具被杀毒误报

大型工具链、cook 工作进程与已签名二进制有时会触发启发式扫描。优先为已知 Epic/Unreal 路径添加排除，而不是完全关闭防护。

1. 1

   确认下载路径

   通过已认证账户的 Epic Games Launcher 安装。避免来源不明的镜像归档。见信任与安全。

2. 2

   先查看隔离日志

   若扫描后 UnrealEditor.exe、UnrealBuildTool 或 cook 工作进程消失，请从隔离区恢复，并在添加排除前记录规则名称。

3. 3

   谨慎添加文件夹排除

   若杀毒产品支持基于路径的排除，请排除引擎安装目录、项目文件夹与 DDC 路径。请勿排除整个系统盘。

4. 4

   在启动器中重新校验

   恢复文件后，使用启动器 Verify，以便从 Epic 下载集修复缺失二进制。

指南 05

Windows 11 上安装 UE 5.8 的基础步骤

Windows 10 与 Windows 11 64 位均为受支持的开发平台。全新 Windows 11 机器在首次启动编辑器前，仍需 GPU 驱动、Visual Studio 工作负载与足够可用磁盘。

1. 1

   更新 GPU 驱动

   安装 GPU 厂商当前的 Studio 或 Game Ready 驱动。过时驱动常导致硬件光追异常，并在首个 Lumen 场景崩溃。

2. 2

   安装 Visual Studio 工作负载

   对于 C++ 项目（以及许多打包路径），请安装「使用 C++ 的桌面开发」以及您引擎版本所点名的 Windows SDK。

3. 3

   若构建异常失败，启用长路径

   深层 Intermediate 目录树可能触及 MAX_PATH。当构建工具报告路径被截断时，请在 Windows 策略中启用长路径支持。

4. 4

   创建 Epic 账户并安装启动器

   登录后，从 Library 标签安装 Unreal Engine 5.8，再创建或打开项目。需求表见下载页。

5. 5

   用模板做冒烟测试

   导入大型制作场景前，先打开 First Person 或空白模板。确认 PIE 可运行，再逐步加入 Nanite/Lumen 内容。