跳转至

Godot — 破坏性变更

最后验证：2026-02-12

不同 Godot 版本之间的变更，重点介绍 LLM 训练数据截止日期之后的变更（4.4+）。

4.5 → 4.6（2026 年 1 月 — 截止日期后，HIGH RISK）{#45-46-jan-2026-post-cutoff-high-risk}

子系统 变更 详情
物理 Jolt 现为默认 3D 物理引擎 新项目自动使用 Jolt。现有项目保留原有设置。部分 HingeJoint3D 属性（如 damp）仅适用于 GodotPhysics。
渲染 Glow 在色调映射（tonemapping）之前处理 之前是在色调映射之后。包含 glow 的场景看起来会有所不同。请在 WorldEnvironment 中调整强度/混合。
渲染 Windows 上默认使用 D3D12 之前是 Vulkan。以获得更好的驱动程序兼容性。
渲染 AgX tonemapper 新增控制项 新增白点（white point）和对比度参数。
Core Quaternion 初始化为单位四元数 之前是零。不太可能影响大多数代码，但技术上属于破坏性变更。
UI 双焦点系统 鼠标/触摸焦点现在与键盘/手柄焦点分离。视觉反馈因输入方式而异。
动画 IK 系统完全恢复 通过 SkeletonModifier3D 节点提供 CCDIK、FABRIK、Jacobian IK、Spline IK、TwoBoneIK。
编辑器 默认启用新的“现代”主题 灰度取代蓝色调。恢复方法：编辑器设置 → 界面 → 主题 → 样式：经典
编辑器 “选择模式”按键已更改 新的“选择模式”（v 键）可防止意外变换。旧模式已重命名为“变换模式”（q 键）。
2D TileMapLayer 场景瓦片旋转 场景瓦片现在可以像图集瓦片一样旋转。
本地化 CSV 复数形式支持 复数形式不再需要 Gettext。新增上下文列。
C# 自动字符串提取 翻译字符串可从 C# 代码自动提取。
插件 新增 EditorDock 类 用于插件停靠面板的专用容器，支持布局控制。

4.4 → 4.5（2025 年末 — 截止日期后，HIGH RISK）{#44-45-late-2025-post-cutoff-high-risk}

子系统 变更 详情
GDScript 新增可变参数 函数可接受 ... 任意参数 — 新的语言特性
GDScript @abstract 装饰器 抽象类和抽象方法现在可强制执行
GDScript 脚本回溯 即使在 Release 构建中也可获得详细的调用堆栈
渲染 模板缓冲支持 用于高级视觉效果的新能力
渲染 SMAA 1x 抗锯齿 新的后期处理 AA 选项
渲染 Shader Baker 预编译着色器 — 据称在某些演示中启动速度提升 20 倍
渲染 弯曲法线贴图、镜面反射遮蔽 新的材质特性
无障碍 屏幕阅读器支持 Control 节点可通过 AccessKit 与无障碍工具配合使用
编辑器 实时翻译预览 在编辑器中测试不同语言的 GUI 布局
物理 3D 插值重新架构 从 RenderingServer 迁移到 SceneTree。API 不变，但内部实现不同。
动画 BoneConstraint3D 新增：AimModifier3D、CopyTransformModifier3D、ConvertTransformModifier3D
资源 新增 duplicate_deep() 用于深度复制嵌套资源的新显式方法
导航 专用 2D 导航服务器 不再代理 3D 导航；2D 游戏的导出包更小
UI FoldableContainer 节点 新增手风琴式容器，用于可折叠的 UI 分区
UI Control 递归行为 可禁用整个节点层级中的鼠标/焦点交互
平台 visionOS 导出支持 新增平台目标
平台 SDL3 游戏手柄驱动 将手柄处理委托给 SDL 库
平台 Android 16KB 页面支持 Google Play 要求面向 Android 15+ 的应用必须支持

4.3 → 4.4（2025 年中 — 接近截止日期，待验证）{#43-44-mid-2025-near-cutoff-verify}

子系统 变更 详情
Core FileAccess.store_* 返回 bool 之前是 void。方法包括：store_8、store_16、store_32、store_64、store_buffer、store_csv_line、store_double、store_float、store_half、store_line、store_pascal_string、store_real、store_string、store_var
Core OS.execute_with_pipe 新增可选 blocking 参数
Core RegEx.compile/create_from_string 新增可选 show_error 参数
渲染 RenderingDevice.draw_list_begin 移除多个参数；新增 breadcrumb 参数
渲染 着色器纹理类型 参数/返回类型从 Texture2D 改为 Texture
粒子 .restart() 方法 新增可选 keep_seed 参数（CPU/GPU 2D/3D）
GUI RichTextLabel.push_meta 新增可选 tooltip 参数
GUI GraphEdit.connect_node 新增可选 keep_alive 参数

4.2 → 4.3（在训练数据中 — LOW RISK）{#42-43-in-training-data-low-risk}

子系统 变更 详情
动画 Skeleton3D.add_bone 返回 int32 之前是 void
动画 bone_pose_updated 信号 由 skeleton_updated 取代
TileMap TileMapLayer 取代 TileMap 每个图层一个节点，取代多图层单节点
导航 NavigationRegion2D 移除 avoidance_layers、constrain_avoidance 属性
编辑器 EditorSceneFormatImporterFBX 重命名为 EditorSceneFormatImporterFBX2GLTF
动画 AnimationMixer 基类 AnimationPlayer 和 AnimationTree 现在继承自 AnimationMixer

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/Claude-Code-Game-Studios