故障排除

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

参见

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

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

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

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

当我在编辑器中旋转 3D 相机时，栅格消失了，网格也变黑了。

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

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

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

此编辑器或项目花了很长时间才启动。

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

点击系统控制台后，Godot 编辑器没有响应。

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

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

在项目管理器和编辑器窗口的左上角出现“NO DC”之类的文本。

这是由于 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 的文件系统是大小写不敏感的。