Godot4_文档学习3_关于Godot_故障排除

故障排除 Troubleshooting

本页列出了使用Godot时遇到的常见问题以及可能的解决方案。

这是一个已知问题，尤其是在macOS上，因为大部分Mac都配备了Retina显示屏（视网膜屏）。由于Retina显示屏的像素密度极高，所有内容都必须以更高分辨率渲染。这会增加GPU的负载并降低感知性能（perceived performance）。

有多种方法可以提高性能和电池寿命：

在3D中，单击左上角的 透视，Perspective 按钮并启用 半分辨率，Half Resolution 。3D视窗（Viewport）现在将以一半分辨率渲染，速度最高可提高到四倍。
打开编辑器设置并将低处理器模式睡眠（微秒）（Low Processor Mode Sleep （μsec）） 的值增加到33000（30FPS，即1000/33≈30）。该值用于确定要渲染的帧之间的微秒数。增大该值将使编辑器感知反应更小，但有助于显著降低GPU和CPU的使用率。
若你有一个会引起编辑器连续重绘的节点（如粒子particles），请隐藏它并使用 _ready() 方法中的脚本显示它。这样，它会在编辑器中隐藏，但在运行项目中仍可以看到。

这是一个已知的问题。可变刷新率显示器（Variable refresh rate monitors）需要不断调整伽马曲线，以随着时间的推移发出一致的光量。当刷新率变化很大时，这可能会导致图像的黑暗区域出现闪烁，这是因为Godot编辑器仅在必要时重绘。

有几种解决方法：

在编辑器设置中启用 界面>编辑器>持续更新 。

请记住，这会增加功耗和热量/噪音排放，因为编辑器现在将不断渲染，即使屏幕上没有任何变化。为了缓解这种情况，你可以在编辑器设置中将 低处理器模式睡眠（微秒） 增加到33000（30FPS）。
或者，在显示器或图形驱动程序中禁用可变刷新率。
使用显示器OSD中的 VRR控制 或 微调暗区（Fine Tune Dark Areas） 选项可以减少某些显示器上的VRR闪烁。这些选项可能会增加输入延迟或导致黑色粉碎（crushed black，黑色粉碎是指图像的特别暗区域失去保真度）。
若使用OLED显示屏，请使用编辑器设置中预设的 黑色（OLED） 编辑器预设主题。得益于OLED完美的黑电平，这可以隐藏VRR闪烁。

当使用基于Vulkan的渲染器（Forward+ 或 Forward Mobile）时，首次启动预计会相对较长。这是因为着色器（shader）需要先编译才能缓存。在更新Godot、更新显卡驱动或切换显卡后，着色器也需要再次缓存。

若首次启动后问题仍然存在，则可能是你连接了特定的USB外设时，触发了Windows上的一个已知bug。特别地，Corsair的iCUE软件似乎会导致此错误。尝试将USB外设的驱动程序更新至最新。若bug仍然存在，你需要在打开编辑器之前断开特定外设的连接。然后重连外设。

在启用系统控制台的情况下在Windows上运行Godot时，你可能会通过在命令行串口内单击意外启动了 选择模式 。这种特定于Windows的行为会暂停应用程序，以便你在系统控制台内选择文本。Godot无法覆盖此特定于系统的行为。

要解决此问题，请选择系统控制台窗口并按Enter键退出选择模式。

这是由于NVIDIA显卡驱动程序注入覆盖层来显示信息造成的。

要在Windows上禁用该覆盖层，请将显卡驱动程序设置恢复为NVIDIA控制面板中的默认值。

要在Linux上禁用此覆盖，请打开 nvidia-settings ，转至 X Screen 0 > OpenGL Settings ，然后取消选中 启用图形API视觉指示器，Enable Graphics API Visual Indicator 。

左边是正确的外观；右边是由于图形驱动程序锐化而导致外观过度锐化

如果编辑器或项目显示过于锐利，这可能是由于图形驱动程序在所有Vulkan或OpenGL应用程序上强制进行图像锐化。你可以在图形驱动程序的控制面板中禁用此行为：

NVIDIA(Windows)： 打开开始菜单并选择 NVIDIA控制面板，NVIDIA Control Panel 。打开左侧的 管理3D设置，Manage 3D settings 选项卡。在中间的列表中，滚动到 图像锐化，Image Sharpening 并将其设置为 锐化关闭，Sharpening Off 。