快速开始

GDCC 是一个开源的 GDScript 编译器和工具链，可以将 GDScript 脚本编译为纯 C 代码并通过 GDExtension 接口执行的本机动态依赖库模块。

安装

从 GDCC GitHub Releases 页面下载 GDCC。

你将会看到两种发行包：

• gdcc-<版本>-<系统>-<架构>.zip，仅包含 gdcc 启动器和核心文件。
• gdcc-<版本>-<系统>-<架构>-full.zip，除了上述文件之外，还额外打包了运行所需的全部工具链，开箱即用。

在后续更新时，你可以直接下载仅包含仅包含 gdcc 启动器和核心文件的包覆盖更新。

编译脚本

基本命令格式：

gdcc [options] <files...>

编译单个脚本：

gdcc -o build/demo src/player.gd

将多个脚本编译到同一个模块：

gdcc -o build/demo src/player.gd src/enemy.gd

编译 Godot 项目中的脚本

编译属于 Godot 项目的脚本时，传入项目文件可让 GDCC 生成 .gdextension 元数据：

gdcc --project game/project.godot -o build/demo game/src/player.gd

常用选项

• -o / --output <output>：设置输出目标路径。省略时，GDCC 会根据输入文件名推导默认名称。
• --gde <version>：选择 Godot GDExtension API 版本。目前仅支持 4.5.1（兼容更高版本）。
• --opt / --optimize <level>：选择 debug 或 release。
• --target <platform>：选择目标平台，例如 linux-x86-64、windows-x86-64 或 linux-aarch64。
• --prefix <prefix> 和 --class-map Source=Canonical：控制生成的顶层 canonical 类名。