虚幻引擎打包助手

解决什么问题

UE5 项目在编辑器里跑得好好的，打包出来却黑屏、进错地图，或者 Development 构建带着一堆日志上了正式环境——这类问题大多不在渲染，而在打包流程的配置本身。这个技能把 UE 5.4+ 从项目到可分发构建的关键决策整理成一条可复制的路径：启动地图设在哪、Development 和 Shipping 怎么选、Cook 与 Package 的边界在哪、能否用命令行跑可重复的 CI 构建。

核心能力与流程

• 确定启动地图：Game Default Map 决定打包后首次加载的关卡，这是「打包后黑屏」最常见的原因。
• 选择构建配置：Development 保留日志、控制台与 Stats，适合测试；Shipping 移除调试工具，面向发布；DebugGame/Debug 只用于引擎与游戏代码调试。
• 理解 Cook 与 Package：Cooking 把资产转成目标平台格式并打进 .pak 文件；Packaging 在此基础上加入编译好的可执行文件，输出独立可分发的文件集。
• 编辑器打包：Platforms 菜单 → 选择平台 → 设置 Binary Configuration → Package Project → 选择输出目录。
• 命令行构建：使用 RunUAT BuildCookRun（位于 Engine/Build/BatchFiles/）跑 CI 友好的可重复构建，可去掉 -allmaps、改用 -map=Map1+Map2 只 Cook 指定关卡。
• 调整 Packaging 设置：指定要 Cook 的地图与目录、全量重建、压缩方式，以及是否构建所有地图。
• 验证产物：必须运行打包后的可执行文件，确认加载了正确关卡，而不是只看 Cook 成功。

适用边界与坑点

• 不处理商店发布流程，那属于 steam-publish / itch-publish；编辑器内的试玩与迭代也不算打包。
• 只 Cook 不打包可用于刷新内容，但不能替代对最终产物的验证。
• UE5 已移除 Blueprint Nativization，性能优化应把热点逻辑迁移到 C++。
• 首次 Cook 因着色器与全部资产都要从头处理会非常慢，属正常现象，后续 Cook 才是增量的。