用途:把 Godot 4.7 项目变成可运行、可分发的平台构建。适用于安装导出模板、创建或编辑导出预设、从编辑器或无头命令行(CI)导出,以及排查 Web(HTML5)与专用服务器导出的问题。商店发布流程、服务器网络代码本身不属于本技能范围。
主要能力:安装与引擎版本严格匹配的导出模板(编辑器菜单 Manage Export Templates 下载,或离线安装 .tpz);在 Project > Export 中按平台(Windows Desktop、macOS、Linux、Web、Android、iOS)添加预设,设置导出路径、图标、功能与资源包含/排除过滤,预设保存到 export_presets.cfg;从编辑器执行 Export Project(release)或 Export PCK/ZIP;用命令行无头导出,例如 godot --headless --export-release "Windows Desktop" build/windows/game.exe,也支持 --export-debug 与 --export-pack;无头运行项目用于专用服务器或测试,如 godot --headless --path . res://server_main.tscn 与 --quit-after 600;运行时用 OS.has_feature("dedicated_server")、OS.has_feature("web") 等判断构建环境。
使用方式:预设名称必须与 Project > Export 中完全一致(区分大小写与空格,需加引号),命令在含 project.godot 的项目目录执行。导出后应在目标平台冒烟测试。
限制与注意:导出后 res:// 只读,运行时写入须用 user://;非资源文件(如 .json、.txt)不会自动打包,需在预设 Resources > Filters 中添加;Web 使用线程需服务器发送 COOP/COEP 头实现跨源隔离,且必须经 HTTP(S) 提供,不能以 file:// 打开;Android 需配置 SDK/JDK、keystore 与 INTERNET 权限;macOS/iOS 分发需签名与公证;模板版本不匹配会报“No export template found”。更多细节见 references/presets-and-cli.md。