Система предупреждений GDScript

Система предупреждений GDScript дополняет :ref:` строго типизированный GDScript <doc_gdscript_static_typing>`(но она также не может работать без строгой типизации). Она здесь, чтобы помочь вам избежать ошибок, которые трудно обнаружить во время разработки и которые могут привести к ошибкам во время выполнения.

Вы можете настроить предупреждения в Настройках Проекта, в новом разделе под названием GDScript:

Настройка системы предупреждений в проекте

Настройка системы предупреждений в проекте

Вы можете найти список предупреждений для активного файла GDScript в строке состояния редактора сценариев. В приведенном ниже примере есть 3 предупреждения:

Пример системы предупреждений

Пример системы предупреждений

Чтобы игнорировать определенные предупреждения в одном файле, вставьте специальный комментарий в форме #warning-ignore:warning-id или нажмите на ссылку справа от описания предупреждения. Godot добавит комментарий над соответствующей строкой, и код больше не будет вызывать соответствующее предупреждение:

Пример игнорирования системы предупреждений

Пример игнорирования системы предупреждений

Вы также можете игнорировать не одно, а все предупреждения определенного типа в этом файле с помощью # warning-ignore-all:warning-id. Чтобы игнорировать все предупреждения всех типов в файле, добавьте к нему комментарий # warnings-disable.

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

Предупреждения как ошибки

Предупреждения как ошибки