技能介绍

当你把 UE5 项目从编辑器推向玩家时，真正的问题不是「能不能跑」，而是「打出来的包能不能直接启动并加载到正确关卡」。很多构建失败或黑屏并不是代码问题，而是 Maps & Modes 的默认地图、构建配置、Cook 范围或平台工具链没对齐。这个技能把这些环节整理成一条可重复的打包路径，目标是把项目变成可分发的独立构建。

核心能力与工作流

设置启动地图：把 Project Settings → Maps & Modes → Game Default Map 指到目标关卡。打包后首先加载哪个关卡，取决于这里，而不是你最后在编辑器里打开的地图。
选择构建配置：Development 适合测试，保留日志、Stats 和 Console，但不适合最终分发；Shipping 启用完整优化并移除调试工具，适合发布版；DebugGame / Debug 用于引擎或游戏代码调试，Blueprint-only 项目也没有 DebugGame。
理解 Cook 与 Package：Cooking 会将资源转换为目标平台格式并写入 .pak，Packaging 则会在 Cook 基础上把编译后的可执行文件和内容打包成可分发文件。
两种入口：可以从编辑器的 Platforms 菜单选择平台、Binary Configuration 和输出目录；也可以使用 RunUAT BuildCookRun 做命令行构建，更适合 CI 和可重复流程。
调优打包设置：在 Project Settings → Packaging 中控制 Cook 哪些地图和目录、是否全量重建、是否压缩，以及是否构建所有地图。
验证结果：最终验证必须运行打包产物，而不是只看 Cook 成功。启动可执行文件，确认它加载的是预期关卡并正常运行。

适用边界与注意点

这个技能覆盖到生成可分发构建为止。如果要把包发布到 Steam、itch.io 或其他商店，后续分发流程应交给 steam-publish / itch-publish。编辑器里的玩法迭代也不是打包流程，不应混用。

常见坑包括：包启动后黑屏或空关卡，通常是 Game Default Map 没设置，或该地图没有被 Cook；用 Development 包当作发行版，会留下日志/Console 并牺牲性能；运行时缺地图或资源，多半是 Cook 范围没包含对应目录；构建失败则先检查平台 SDK/工具链，例如 Windows 构建工具、Android SDK/NDK 或主机 SDK。另外，UE5 已移除 Blueprint Nativization，不要再依赖它优化性能，热逻辑应迁移到 C++（见 unreal-cpp-gameplay）。首次 Cook 会重新处理着色器和全部资源，速度很慢是正常的，后续 Cook 才会走增量。