为每个项目指定对应的 Godot 引擎版本
绑定操作
在项目管理界面中,每个项目条目旁边都会显示它当前绑定的引擎版本。点击版本号可以打开版本选择弹窗,列出:
- 已安装的版本:可以直接选择,一键绑定
- 推荐版本:GodotHub 根据项目的
project.godot里记录的历史版本推荐的版本 - 需要下载的版本:如果项目对应的引擎没装,可以直接在这里触发下载
选定版本后,GodotHub 保存绑定关系。下次打开项目时会自动用这个版本的引擎启动。

推荐版本的判断逻辑
GodotHub 会尝试从项目的 project.godot 文件里读取一些线索来推荐合适的版本:
- Godot 4.x 项目会自动排除 Godot 3.x 版本
- 项目如果用了 C#,只展示带 Mono 的编辑器版本
- 项目里如果引用了某个特定版本的模块,GodotHub 会优先推荐该版本附近的小版本
不过这个推荐仅供参考,最终用哪个版本由你自己决定。
绑定修改场景
项目引擎升级
当项目需要从 Godot 4.2 升级到 4.5 时:
- 先在 GodotHub 里下载好 Godot 4.5
- 修改项目的版本绑定为 4.5
- 打开项目,让 Godot 编辑器完成自动迁移
- 手动检查代码里是否有废弃 API 需要调整
团队协作时对齐版本
如果团队成员的项目因为各种原因绑定了不同的引擎版本,可以统一修改为团队约定的版本,确保每个人打开同一个项目时环境一致。
回退到旧版本
如果升级后遇到无法解决的问题,随时可以把绑定改回之前的版本。GodotHub 不会删除旧引擎,只是项目不再用它启动而已。