Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Устранение неполадок

На этой странице перечислены распространенные проблемы, возникающие при использовании Godot, и возможные их решения.

См.также

See Использование веб-редактора for caveats specific to the Web version of the Godot editor.

Редактор работает медленно и использует все ресурсы CPU и GPU, делая мой компьютер шумным

Это известная проблема, особенно на macOS, поскольку большинство Mac имеют дисплеи Retina. Из-за более высокой плотности пикселей дисплеев Retina, все должно отрисовываться с более высоким разрешением. Это увеличивает нагрузку на GPU и снижает ощущаемую производительность.

There are several ways to improve performance and battery life:

  • В режиме 3D нажмите кнопку Перспектива в верхнем левом углу и включите Половинное разрешение. Теперь 3D окно просмотра будет отрисовываться с половинным разрешением, что может быть в 4 раза быстрее.

  • Откройте настройки редактора и увеличьте значение Время ожидания в режиме низкой производительности (мкс) до 33000 (30 FPS). Это значение определяет количество микросекунд между кадрами для отрисовки. Большие значения сделают редактор менее отзывчивым, но помогут значительно снизить использование ЦП и ГПС.

  • Если у вас есть узел, который вызывает непрерывную перерисовку редактора (например, частицы), скройте его и покажите с помощью скрипта в методе _ready(). Таким образом, он будет скрыт в редакторе, но все равно будет виден в работающем проекте.

Редактор дергается и мерцает на моем мониторе с переменной частотой обновления (G-Sync/FreeSync)

Это известная проблема. Мониторы с переменной частотой обновления должны непрерывно корректировать свои гамма-кривые, чтобы излучать постоянное количество света со временем. Это может вызывать мерцание в темных областях изображения, когда частота обновления сильно варьируется, что происходит, поскольку редактор Godot перерисовывается только при необходимости.

There are several workarounds for this:

  • Enable Interface > Editor > Update Continuously in the Editor Settings. Keep in mind this will increase power usage and heat/noise emissions since the editor will now be rendering constantly, even if nothing has changed on screen. To alleviate this, you can increase Low Processor Mode Sleep (µsec) to 33000 (30 FPS) in the Editor Settings. This value determines the amount of microseconds between frames to render. Higher values will make the editor feel less reactive but will help decrease CPU and GPU usage significantly.

  • В качестве альтернативы, вы можете отключить переменную частоту обновления на вашем мониторе или в графическом драйвере.

  • VRR flicker can be reduced on some displays using the VRR Control or Fine Tune Dark Areas options in your monitor's OSD. These options may increase input lag or result in crushed blacks.

  • При использовании OLED-дисплея используйте тему редактора Black (OLED), находящаяся в настройках редактора. Это позволяет скрыть мерцание VRR благодаря идеальному уровню черного в OLED.

The editor or project takes a very long time to start

При использовании одного из рендереров на базе Vulkan (Forward+ или Forward Mobile) первый запуск будет долгим. Это связано с тем, что шейдеры необходимо скомпилировать, прежде чем их можно будет кэшировать. Шейдеры также необходимо снова кэшировать после обновления Godot, после обновления графических драйверов или после переключения видеокарты.

If the issue persists after the first startup, this is a known bug on Windows when you have specific USB peripherals connected. In particular, Corsair's iCUE software seems to cause this bug. Try updating your USB peripherals' drivers to their latest version. If the bug persists, you need to disconnect the specific peripheral before opening the editor. You can then connect the peripheral again.

Брандмауэры, такие как Portmaster, также могут блокировать порт отладки. Это приводит к тому, что проект долго запускается и не может использовать отладочные функции в редакторе (например, просмотр вывода print()). Эту проблему можно решить, изменив порт отладки, используемый проектом, в настройках редактора (Сеть> Отладка> Удаленный порт). По умолчанию используется 6007; попробуйте выбрать другое значение, большее, чем 1024, например 7007.

The Godot editor appears frozen after clicking the system console

При запуске Godot через системную консоль на Windows — вы можете случайно включить режим выделения, кликая внутри командного окна. Это специфичное для Windows поведение приостанавливает работу приложения, чтобы вы могли выделить текст в системной консоли. Godot не может отменить это специфическое для системы поведение.

Для решения проблемы, выберите окно этой системной консоли и нажмите Enter, чтобы отключить режим выделения.

The Godot editor's macOS dock icon gets duplicated every time it is manually moved

If you open the Godot editor and manually change the position of the dock icon, then restart the editor, you will get a duplicate dock icon all the way to the right of the dock.

Это связано с ограничением дизайна док-станции macOS. Единственным известным способом решения этой проблемы было бы объединение менеджера проектов и редактора в один процесс, что означает, что менеджер проектов больше не будет порождать отдельный процесс при запуске редактора. Хотя использование одного экземпляра процесса дало бы несколько преимуществ, в ближайшее время это не планируется делать из-за сложности задачи.

Чтобы избежать этой проблемы, сохраните иконку панели редактора Godot в его расположении по умолчанию, созданном macOS.

Some text such as "NO DC" appears in the top-left corner of the Project Manager and editor window

Это вызвано тем, что графические драйверы NVIDIA выводят оверлей для отображения информации.

Чтобы отключить этот оверлей в Windows, восстановите настройки видеодрайвера по умолчанию в контрольной панели NVIDIA.

Чтобы отключить этот оверлей в Linux, откройте nvidia-settings, перейдите в X Screen 0> OpenGL Settings, затем снимите флажок Enable Graphics API Visual Indicator.

The editor or project appears overly sharp or blurry

Правильный вид (слева), чрезмерно резкий вид из-за повышения резкости графическим драйвером (справа)

Правильный вид (слева), чрезмерно резкий вид из-за повышения резкости графическим драйвером (справа)

Если редактор или проект кажутся слишком резкими, это, вероятно, связано с тем, что резкость изображения принудительно устанавливается во всех приложениях Vulkan или OpenGL вашим графическим драйвером. Вы можете отключить это в панели управления графического драйвера:

  • NVIDIA (Windows): Откройте меню Пуск и выберите Панель управления NVIDIA. Откройте вкладку Управление настройками 3D слева. В списке посередине выделите пункт Повышение резкости изображения и установите для него значение Отключение резкости.

  • AMD (Windows): Откройте меню Пуск и выберите AMD Software. Нажмите на значок настроек "шестеренка" в правом верхнем углу. Перейдите на вкладку Графика, затем отключите Усиление резкости изображения Radeon.

Если редактор или проект выглядит слишком размытым, это, скорее всего, связано с тем, что FXAA принудительно включается во все приложения Vulkan или OpenGL вашим графическим драйвером.

  • NVIDIA (Windows): Откройте меню Пуск и выберите Панель управления NVIDIA. Откройте вкладку Управление параметрами 3D слева. В списке посередине прокрутите список до Сглаживание - FXAA и установите для него значение Управляется приложением.

  • NVIDIA (Linux): Откройте меню приложений и выберите Настройки сервера NVIDIA X. Выберите Настройки сглаживания слева, затем снимите флажок Включить FXAA.

  • AMD (Windows): Откройте меню «Пуск» и выберите Программное обеспечение AMD. Нажмите значок настроек «шестеренка» в правом верхнем углу. Перейдите на вкладку Графика, прокрутите страницу вниз и нажмите Дополнительно, чтобы развернуть ее настройки. Отключите Морфологическое сглаживание.

Сторонние утилиты, не зависящие от производителя, такие как vkBasalt, также могут принудительно накладывать резкость или FXAA на все приложения Vulkan. Возможно, вам захочется проверить их конфигурацию.

После изменения параметров в графическом драйвере или сторонних утилитах перезапустите Godot, чтобы изменения вступили в силу.

Если вы все же хотите принудительно настраивать резкость или FXAA в других приложениях, рекомендуется делать это по отдельности, используя систему профилей приложений, предоставляемую панелями управления графических драйверов.

The editor or project appears to have washed out colors

На Windows это обычно вызвано неправильными настройками ОС или монитора, поскольку в настоящее время Godot не поддерживает HDR * *вывод (хотя внутренне он может рендерить в HDR).

Поскольку`большинство дисплеев не предназначены для отображения контента SDR в режиме HDR <https://tftcentral.co.uk/articles/heres-why-you-should-only-enable-hdr-mode-on-your-pc-when -you-are-viewing-hdr-content>`__ рекомендуется отключить HDR в настройках Windows, если не запущены приложения, использующие вывод HDR. В Windows 11 это можно сделать, нажав Windows + Alt + B (этот ярлык является частью приложения Xbox Game Bar). Чтобы автоматически переключать HDR в зависимости от запущенных в данный момент приложений, вы можете использовать AutoActions.

Если вы настаиваете на том, чтобы оставить включенным HDR, можно несколько улучшить результат, обеспечив, чтобы дисплей настроен на использование HGIG тонального отображения (в отличие от DTM), затем с помощью приложения калибровки HDR для Windows. Также настоятельно рекомендуется использовать Windows 11 вместо Windows 10 при использовании HDR. Однако конечный результат, скорее всего, будет хуже, чем при отключении HDR на дисплее.

Поддержка HDR вывода запланирована в будущих релизах.

The editor/project freezes or displays glitched visuals after resuming the PC from suspend

Это известная проблема в Linux с графикой NVIDIA при использовании проприетарного драйвера. Окончательного решения пока нет, поскольку приостановка в Linux + NVIDIA часто приводит к ошибкам при использовании OpenGL или Vulkan. Метод рендеринга совместимости (который использует OpenGL), как правило, менее подвержен проблемам, связанным с вылетами, по сравнению с методами рендеринга Forward+ и Forward Mobile (которые используют Vulkan).

Драйвер NVIDIA предлагает экспериментальную опцию сохранения видеопамяти после приостановки, которая может решить эту проблему. Сообщалось, что эта опция лучше работает с более новыми версиями драйверов NVIDIA.

Чтобы избежать потери работы, сохраняйте сцены в редакторе перед выключение компьютера.

The project works when run from the editor, but fails to load some files when running from an exported copy

Обычно это происходит из-за того, что вы забыли указать фильтр для файлов без ресурсов в диалоге экспорта. По умолчанию Godot будет включать в файл PCK только фактические ресурсы. Некоторые часто используемые файлы, например, файлы JSON, не считаются ресурсами. Например, если вы загружаете test.json в экспортируемый проект, вам нужно указать *.json в фильтре экспорта не-ресурсов. Дополнительную информацию смотрите в Resource options.

Also, note that files and folders whose names begin with a period will never be included in the exported project. This is done to prevent version control folders like .git from being included in the exported PCK file.

На Windows, эта проблема бывает связана с чувствительностью к регистру. Если вы ссылаетесь на ресурс в вашем скрипте, с отличным, от принятой в системе регистром наименований файлов — экспорт проекта проваливается. Это связано с тем, что виртуальная файловая система PCK чувствительна к регистру, тогда как файловая система Windows по умолчанию не чувствительна к нему.