故障排除

这个页面列出了使用 Godot 时的常见问题以及可能的解决办法。

参见

关于 Godot 编辑器 HTML5 版本特定的注意事项，请参阅使用 Web 编辑器。

我在编辑器或项目管理器里做的任何事都会延迟一帧显示。

这是一个 Windows 上 Intel 显卡驱动的已知问题。更新到 Intel 提供的最新版本的显卡驱动应该能够修复这个问题。

你应该使用 Intel 提供的显卡驱动而非你的笔记本生产厂商提供的，因为他们的驱动版本经常是过期了的。

这是一个 Windows 上 Intel 显卡驱动的已知问题。

目前唯一的解决办法是切换到 GLES2 渲染器。你可以在编辑器的右上角或者项目设置中切换。

如果你使用的电脑支持切换显卡，比如 NVIDIA Optimus，你可以使用独立显卡运行 Godot。

当您连接了特定的 USB 外设时，这是 Windows 上的一个已知错误。特别是，海盗船的 iCUE 软件似乎引起了该错误。尝试将 USB 外设的驱动程序更新为最新版本。如果错误仍然存在，则需要在打开编辑器之前断开故障外围设备的连接。然后，您可以再次连接外围设备。

这是个已知错误，是由 Windows 上的第三方程序 Stardock Fences 引起的。已知的绕过方法是在使用 Godot 时禁用 Stardock Fences。

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

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

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

要在 Windows 上禁用此覆盖，请在 NVIDIA 控制面板中将图形驱动程序设置恢复为默认值。

要在 Linux 上禁用此覆盖，请打开 nvidia-settings，转到 X Screen 0 > OpenGL Settings，然后取消选中 Enable Graphics API Visual Indicator。

与编辑器不同，默认情况下，该项目未标记为支持 DPI。这样做是为了提高性能，特别是在 hiDPI 中渲染 3D 场景较慢的集成图形上。

要解决此问题，请打开项目 > 项目设置然后启用 显示 > 窗口 > DPI > 允许 hiDPI。此外，请确保你的项目已经配置为支持多分辨率。

这是一个已知问题。解决方法是打开项目 > 项目设置并开启 显示 > 窗口 > DPI > 允许 hiDPI。此外，请确保你的项目已经配置为支持多分辨率。

这通常是在导出对话框中忘记筛选非资源文件所导致的。默认情况下，Godot只会将实际的资源包含在 PCK 文件中。一些常用的文件，例如 JSON 文件，不会被视为资源。例如，当你在导出的项目中加载 test.json 时，你需要在非资源导出过滤器中指定 *.json。详见：资源选项。

在 Windows 上，也可能是大小写敏感性的问题。如果你在脚本里引用资源时所使用的大小写与文件系统中的不符，在导出项目后就会载入失败。这是因为虚拟 PCK 文件系统是大小写敏感的，而 Windows 的文件系统是大小写不敏感的。