Godot — Version Reference
| Field |
Value |
| Engine Version |
4.7.2-stable（2026-08-18 发布） |
| Project Pinned |
2026-09-07 |
| LLM Knowledge Cutoff |
May 2025（训练数据覆盖 ~4.3/4.4） |
| Risk Level |
MEDIUM（2026-09-12 降级）——4.5→4.7 API 级破坏性变更已逐条核实（源：官方迁移指南），无一条破坏本项目架构契约；残余风险 = 4.8（dev 阶段）未来升级 + 未覆盖的运行期边角行为，代理写码规则不变：不确定的 API 一律查 docs.godotengine.org/en/4.7/ 或 WebSearch 核实后再用 |
| Last Docs Verified |
2026-09-12（4.5/4.6/4.7 迁移指南逐条核实 + 版本检查：4.7.2 仍为最新稳定版，4.8 仅 dev 快照） |
Post-Cutoff Version Timeline
| Version |
发布 |
与本项目相关要点 |
| 4.4 |
2025-03（训练覆盖边缘） |
— |
| 4.5-stable |
2025-09-15 |
stencil 效果、无障碍改进；4.5.2（2026-03-19）为末版维护；逐条变更已核实（2026-09-12） |
| 4.6-stable |
2026-02 起（4.6.1 2026-02） |
Modern 主题、flexible docks、编辑器 QoL；4.6.3 维护；逐条变更已核实（2026-09-12） |
| 4.7-stable |
2026-06（4.7.2 = 2026-08-18，本项目锁定） |
见下；逐条变更已核实（2026-09-12） |
| 4.8 |
dev 快照 1–4（开发中） |
无稳定版发布日期；稳定版发布后跑 /setup-engine refresh |
4.7 与本项目相关的变更（已核实）
Tween.tween_await()（信号等待）——不影响 B1"结算逻辑禁 await"约束（那是设计约束，非引擎限制）- Control
offset_transform_*（平移/旋转/缩放 Control 而不影响容器布局）——D1 HUD 可用
- DrawableTexture2D、AreaLight3D、HDR 输出、新 Asset Store——本项目暂不依赖
- 2D：CollisionShape2D 单向碰撞方向属性、conic gradient、AtlasTexture 进 TextureRect
- GDScript 两条语义变化（打包数组元素赋值不触发属性 setter；类型化返回覆盖必须显式 return）——详见
current-best-practices.md
- 新项目默认值已变（stretch mode
canvas_items、aspect expand；4.6 起 Windows 驱动 D3D12）——详见 current-best-practices.md
- Android/iOS/XR 增强——本项目 PC 先行，无关
Migration Guides（升级/写码前必读）
Note
MEDIUM 风险处置（2026-09-12 更新）：4.5→4.7 的 API 级破坏性变更清单已逐条核实并入 breaking-changes.md，deprecated → replacement 对照已并入 deprecated-apis.md；对本项目的结论 = 无一破坏 GDD 已锁架构契约。残余风险两项：① 4.8 未来升级（dev 阶段，稳定版后 refresh）；② 运行期边角行为（迁移指南未覆盖的引擎内部行为差异）——代理写码规则保持不变：不确定的 API 一律查 docs.godotengine.org/en/4.7/ 或 WebSearch 核实后再用。
Verification History
| 日期 |
动作 |
| 2026-09-07 |
初次锁定 4.7.2；核实版本时间线与 4.7 特性清单 |
| 2026-09-12 |
/setup-engine refresh：4.5/4.6/4.7 官方迁移指南逐条核实（breaking-changes.md 逐条清单 + deprecated-apis.md 对照表 + 新建 current-best-practices.md）；版本检查确认 4.7.2 仍为最新稳定版（4.8 仅 dev）；风险等级 HIGH → MEDIUM |
