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

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

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

Примечание

Чтобы увидеть раздел GDScript на боковой панели, необходимо включить Advanced Settings. Вы также можете выполнить поиск по запросу "GDScript", если расширенные настройки отключены.

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

Чтобы игнорировать отдельные предупреждения в файле, используйте аннотацию @warning_ignore. Вы можете нажать на ссылку «ignore» слева от описания предупреждения. Godot добавит аннотацию над соответствующей строкой, и код больше не будет вызывать соответствующее предупреждение:

Чтобы игнорировать несколько предупреждений в области файла, используйте аннотации @warning_ignore_start и @warning_ignore_restore. Вы можете опустить аннотацию @warning_ignore_restore, если хотите игнорировать указанные типы предупреждений до конца файла.

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