游戏引擎 / 系统课时
配置目标平台并完成导出
配置目标平台并完成导出
本课以 Godot 4 的 Windows Desktop 平台为例,将已通过本地测试的 3D 小游戏导出为可交付的构建产物。完成后,你将得到能在目标系统独立启动的可执行文件,并掌握模板缺失、资源遗漏和构建后运行失败的基本排查方法。
学习目标
- 准备匹配编辑器版本的导出模板,并建立目标平台预设。
- 设置资源打包范围,使用图形界面或命令完成发布导出。
- 检查交付目录,并在不依赖项目源码的环境中验证运行。
准备平台导出环境
先在编辑器中按 F5 验证项目主场景能够启动,并确认使用的 Godot 4 版本。打开 Editor > Manage Export Templates,安装与当前编辑器版本匹配的导出模板;离线环境可通过模板管理器导入预先下载的模板文件。
导出模板负责生成目标平台的游戏运行程序,与用于编辑场景的 Godot 编辑器不是同一份产物。如果导出窗口提示模板缺失或版本不匹配,应先补齐模板,而不是反复调整游戏资源。
建立 Windows Desktop 预设
选择 Project > Export...,点击 Add... 新建 Windows Desktop 预设。首次交付建议先使用易于核对的资源范围,确认成品完整启动后,再根据体积需求缩减资源。

按以下要点检查预设:
- 预设名称保持为
Windows Desktop,确保后续命令中的名称与export_presets.cfg完全一致。 - 在平台选项中按目标设备选择处理器架构;普通 64 位 Intel/AMD Windows 电脑通常使用
x86_64。 - 在
Resources中先选择导出所有项目资源。如果使用了FileAccess读取.json、.csv等文件,再设置非资源文件的包含过滤规则。 - 选择项目目录之外的输出位置,避免构建产物混入项目资源。需要可运行的游戏时选择
Export Project,不能只导出PCK/ZIP资源包。
对资源采用“仅导出所选场景及其依赖”的策略时,尤其要注意运行时按字符串加载的其他关卡或角色资源:它们可能未被静态依赖自动覆盖。先完成全资源发布验证,再考虑精简更容易定位问题。
执行发布构建
图形界面可以直接点击 Export Project 保存目标程序;自动化构建则使用 --export-release。预设保存在项目根目录的 export_presets.cfg,因此应先通过界面创建并保存预设,才能按名称从命令行选择它。
以下为 Windows PowerShell 可执行示例。执行前把 <PROJECT_PATH> 换成项目目录、<OUTPUT_PATH> 换成项目之外的导出目录,并确保 godot 命令可用;若未配置环境变量,可将命令名换成 Godot 编辑器可执行文件的实际路径。
# 输出目录必须在导出前建立
New-Item -ItemType Directory -Force -Path "<OUTPUT_PATH>" | Out-Null
godot --headless --path "<PROJECT_PATH>" --export-release "Windows Desktop" "<OUTPUT_PATH>/MiniGame.exe"
# 失败时停止,不把旧文件误判成这次导出的成果
if ($LASTEXITCODE -ne 0) { throw "Godot 导出失败" }
if (-not (Test-Path "<OUTPUT_PATH>/MiniGame.exe" -PathType Leaf)) { throw "未找到可执行文件" }
Write-Output "导出文件已生成"预期输出(Godot 自身可能另有进度日志,以下为脚本最后一行):
导出文件已生成生成 .exe 只证明构建步骤通过,不代表所有依赖都已正确随包提供。导出实际产生了单独的 .pck 时,必须连同程序一起交付;如果资源已嵌入程序,则无需额外复制 .pck。
在独立环境中验收
把整个导出目录复制到一台符合目标架构的 Windows 机器,或至少复制到不含项目源码的新目录,从 MiniGame.exe 启动。不要在编辑器内用 F5 代替成品验收。建议实际完成进入菜单、开始关卡、角色控制、模型和纹理显示、音效播放、场景切换及退出这些关键操作。
| 现象 | 优先检查 |
|---|---|
| 导出按钮不可用或提示模板缺失 | 导出模板是否安装且版本一致 |
| 命令报告找不到预设 | export_presets.cfg 是否存在、名称是否为 Windows Desktop |
| 构建成功但模型或配置缺失 | Resources 筛选、动态路径及非资源文件包含规则 |
| 文件复制后无法运行 | 是否漏带 .pck、目标架构是否正确,以及程序启动时的错误日志 |
交付时保留可复现的预设配置,并将最终验证过的构建目录整体打包。只有在没有编辑器和项目源码参与的情况下,入口与核心玩法仍能正常运行,才算完成一次可交付的导出。