发布候选版本：Godot 4.5.2

2026-03-19

源地址：https://godotengine.org/article/maintenance-release-godot-4-5-2/

虽然大多数用户现在已经将他们的项目升级到Godot 4.6，但由于各种原因，有些人不得不留在之前的4.5分支上，所以我们尽最大努力为他们提供重要的修复。

我们的发布支持政策是，我们积极支持给定的稳定分支，直到其继任者发布了第一个补丁，这发生在一个月前的4.6.1版本。但是4.5.2已经在RC1的管道中了，我只是从来没有完成它……所以是时候用一个稳定的版本来结束它了！

注意：在此维护版本之后，4.5分支将切换到部分支持，4.4分支将终止使用，不会获得新的补丁版本。

维护版本对于升级来说是安全的，但我们建议始终进行备份，或使用Git等版本控制系统来保护您的项目，以防损坏或数据丢失。

如果您有能力，请考虑为该项目提供财务支持。Godot由志愿者和小型付费贡献者团队共同维护。您的捐款将用于赞助他们的工作，并确保他们能够全身心投入到满足项目需求的工作中。

立即下载Godot 4.5.2，或尝试Godot编辑器的在线版本。

下载 Godot 4.5.2

Linux

macOS

Windows

标准

标准

标准

.NET

.NET

.NET

导出模板及其他下载内容 捐献

封面插图来自幽灵快车，这是一款3D益智游戏，让你负责唯一一家愿意轮流运送人类和亡灵的铁路服务，换句话说，就是幽灵世界中的山羊、卷心菜和狼问题！幽灵快车由Draknek&Friends的获奖设计师创作，他们最近开始在新游戏中使用Godot。你可以在Steam、itch.io、App Store和Google Play上购买游戏，并在Bluesky或Mastodon上关注开发者。

亮点

此版本对渲染和平台移植区域进行了重要修复，特别是：

由于Godot 4.5中Android维护人员所做的工作，我们一直在为Android导出模板提供调试符号，用户可以将其上传到Google Play以符号化其崩溃日志。这使得Rift Riff、Kamaeru和Spooky Express等游戏的开发者能够分享一些玩家在游戏中遇到的崩溃的详细堆栈痕迹。这些开发人员还协助渲染维护人员调试问题，因此Skyth可以为发现的大多数问题编写修复程序，这些修复程序在本版本中可用。

如果你有一款使用Vulkan Mobile在Google Play上发布的游戏，我们强烈建议升级到4.5.2或更高版本，因为这应该可以解决你的游戏可能出现的许多崩溃报告。如果使用兼容性，也有值得获得的重大崩溃修复。

仍然在渲染方面，我们已经移植了一些Direct3D 12错误修复和性能改进，特别是减少了初始着色器编译时间，使其更接近我们使用Vulkan的情况。虽然Godot 4.6有更多的修复程序和新功能，使其能够使Direct3D 12成为Windows上的默认驱动程序，但对于4.5.2，它仍然是可选的，但这些修复程序应该会改善选择使用此API的开发人员的体验。

最后，在渲染方面，使用Metal（Forward+或Mobile渲染方法）的iOS导出现在将默认限制对A12设备或更新设备的支持。这意味着排除一些技术上支持Metal但难以正常运行Godot游戏的旧iPad。您可以在导出预设中切换此选项，因为这只是根据您的渲染方法更改其默认状态。

变更

107位贡献者为本次发布提交了218项修复。请参阅我们的交互式更新日志。

  • 2D: Check for tiles outside texture on TileSet atlas settings changes (GH-112271).
  • 3D: Don’t redraw Sprite3D/AnimatedSprite3D outside the tree (GH-112593).
  • Animation: Separate branching ping-pong time and delta (GH-112047).
  • Audio: Fix AudioStreamPolyphonic to honor AudioStreamPlayer.pitch_scale (GH-110525).
  • Audio: Check if on tree before calling can_process() (GH-114966).
  • C#: Fix dotnet class lookup returning modified names instead of engine names (GH-112023).
  • C#: Ensure .NET editor supports Visual Studio 2026 (GH-112961).
  • Core: Fix load_threaded_get returning null when used with CACHE_MODE_IGNORE (GH-111387).
  • Core: Improve determinism of UIDs (GH-111858).
  • Core: Fix duplicating node references of custom node type properties (GH-112076).
  • Editor: Visual Shader: Fix nodes’ relative positions changed in a different display scale (GH-97620).
  • Editor: Fix editing resources in the inspector when inside an array or dictionary (GH-106099).
  • Editor: Fix switch to GameView when closing game window (GH-111811).
  • Editor: EditorRun: Load override.cfg to get window configuration for embedded mode (GH-111847).
  • Editor: Add donate button to project manager (GH-111969).
  • Editor: Fix file duplication making random UID (GH-112015).
  • Export: Disable shader baker when exporting as dedicated server (GH-112361).
  • Export: iOS: Automatically enable iphone-ipad-minimum-performance-a12 if project is using Forward+/Mobile renderer (GH-114098).
  • Export: Fix Android export with multiple architectures failing when GDExtension includes native dependencies (GH-114483).
  • GDExtension: iOS: Fix loading of xcframework dynamic libraries (GH-112784).
  • GDScript: LSP: Fix goto native declaration (GH-111478).
  • GUI: Fix update order for exclusive child window (GH-94488).
  • GUI: FoldableContainer: Override has_point to use title rect when folded (GH-110847).
  • GUI: Fix IME input in multiple windows at once (GH-111865).
  • Network: Normalize IP parsing, fix IPv6, tests (GH-114827).
  • Particles: Fix CPUParticle3D not randomizing (GH-112514).
  • Physics: Fix transform updates sometimes being discarded when using Jolt (GH-115364).
  • Platforms: Android: Add support for Android XR devices to the Godot XR Editor (GH-112776).
  • Platforms: Android: Fix ANRs when shutting down the engine due to the render thread (GH-114207).
  • Platforms: Android: Trigger save of the RD pipeline cache on application pause (GH-114463).
  • Platforms: Apple Embedded: Fix static .a/.xcframework library loading in open_dynamic_library (GH-117469).
  • Platforms: macOS: Fix ~500ms hang on transparent OpenGL window creation on macOS 26 (GH-111657).
  • Platforms: macOS: Fix microphone issue (GH-111691).
  • Platforms: macOS: Disable window embedding code in export templates (GH-113966).
  • Platforms: Linux: Add SSE4.2 support runtime check (GH-112279).
  • Platforms: Linux/X11: Fix input delay regression (GH-113537).
  • Platforms: Windows: Fix EnumDevices stall using IAT hooks (GH-113013).
  • Platforms: Windows: Set current driver when ANGLE init fails (GH-117253).
  • Rendering: Round values after renormalization when generating mipmaps (GH-111841).
  • Rendering: Use AABB center instead of origin for visibility fade (GH-113486).
  • Rendering: D3D12: Fix not checking for fullscreen clear region correctly (GH-111321).
  • Rendering: D3D12: Fix specialization constant patching (GH-111356).
  • Rendering: D3D12: Greatly reduce shader conversion time & fix spec constant bitmasking (GH-111762).
  • Rendering: OpenGL: Add all PowerVR devices to the transform feedback shader cache ban list (GH-111329).
  • Rendering: OpenGL: Use GL_FRAMEBUFFER instead of GL_DRAW_FRAMEBUFFER when doing final blit to the screen framebuffer to work around OBS bug (GH-111834).
  • Rendering: Vulkan: Create new pools when they become fragmented (GH-114313).
  • Rendering: Vulkan: Implement workaround for GPU driver crash on Adreno 5XX (GH-114416).
  • Rendering: Vulkan: Create separate graphics queue instead of reusing the main queue when transfer queue family is unsupported (GH-114476).
  • Shaders: Fix VisualShader conversion failing with subresources (GH-109375).
  • Thirdparty: libpng: Update to 1.6.55 (GH-117564).
  • Thirdparty: mbedTLS: Update to version 3.6.5 (GH-111845).
  • Thirdparty: pcre2: Update to 10.46 (GH-114766).

已知的不兼容性

截至目前，尚未发现与之前的Godot 4.5.x版本存在任何已知的不兼容问题。我们鼓励所有用户升级至4.5.3版本。

如果您在升级到4.6.2版本后，发现项目出现了任何异常行为变化，请在GitHub上提交问题。

报告问题

作为测试人员，如果您在此版本中遇到问题，我们鼓励您提交错误报告。请先在GitHub上检查现有问题，使用相关关键词进行搜索，以确保您遇到的错误尚未被报告。

特别是，任何可能导致项目性能退化的变更都需特别报告（例如，如果某项功能在之前的4.x版本中运行良好，但在当前快照中不再有效）。

支持

Godot是一款非盈利的开源游戏引擎，由数百名贡献者在业余时间开发，同时，得益于Godot社区的慷慨捐赠，还聘请了少数兼职和全职开发人员。衷心感谢每一位为该项目贡献时间或资金支持的人！

如果您想在经济上支持该项目，并帮助我们确保未来的招聘工作，您可以通过Godot发展基金来实现这一目标。

如果您想为该项目提供财务支持，并帮助我们确保未来的人才招聘，您可以通过Godot基金会管理的Godot发展基金平台进行捐赠。此外，您还可以选择其他更适合您的捐赠方式。

现在捐赠