Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Система предупреждений GDScript
Система предупреждений GDScript дополняет static typing (но она также не может работать без строгой типизации). Она здесь, чтобы помочь вам избежать ошибок, которые трудно обнаружить во время разработки и которые могут привести к ошибкам во время выполнения.
Настроить предупреждения можно в настройках проекта в разделе GDScript:
Примечание
Чтобы увидеть раздел GDScript на боковой панели, необходимо включить Advanced Settings. Вы также можете выполнить поиск по запросу "GDScript", если расширенные настройки отключены.
Список предупреждений для активного файла GDScript можно найти в строке состояния редактора скриптов. В примере ниже показано два предупреждения:
Чтобы игнорировать отдельные предупреждения в файле, используйте аннотацию @warning_ignore. Вы можете нажать на ссылку «ignore» слева от описания предупреждения. Godot добавит аннотацию над соответствующей строкой, и код больше не будет вызывать соответствующее предупреждение:
Чтобы игнорировать несколько предупреждений в области файла, используйте аннотации @warning_ignore_start и @warning_ignore_restore. Вы можете опустить аннотацию @warning_ignore_restore, если хотите игнорировать указанные типы предупреждений до конца файла.
The names of the warnings to ignore match the names of the project settings.
For example, to ignore the warning configured by the
debug/gdscript/warnings/unused_variable
project setting, use @warning_ignore("unused_variable").
An autocompletion dialog displays when entering a warning name in the
annotation, listing all available warnings.
Предупреждения не помешают запуску игры, но при желании их можно преобразовать в ошибки. В этом случае игра не скомпилируется, пока вы не исправите все предупреждения. Перейдите в раздел GDScript в настройках проекта, чтобы включить эту опцию для нужного предупреждения. Вот тот же файл, что и в предыдущем примере, но с предупреждением unused_variable как ошибкой:
