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.

Система попередження GDScript

Система попередження доповнює статичну типізацію (але може працювати і без неї). Вона допоможе вам допомогти уникнути помилок, які важко помітити під час розробки, і які можуть призвести до помилок при виконанні.

Ви можете налаштувати попередження в налаштуваннях проекту в розділі під назвою GDScript:

../../../_images/typed_gdscript_warning_system_settings.webp

Примітка

Ви повинні ввімкнути Додаткові налаштування, щоб побачити розділ GDScript на бічній панелі. Ви також можете шукати "GDScript", коли додаткові налаштування вимкнено.

Ви можете знайти список попереджень для активного файлу GDScript у рядку стану редактора сценаріїв. У прикладі нижче є 2 попередження:

../../../_images/typed_gdscript_warning_example.webp

Щоб ігнорувати окремі попередження у файлі, використовуйте анотацію @warning_ignore. Ви можете натиснути посилання ігнорувати ліворуч від опису попередження. Godot додасть анотацію над відповідним рядком, і код більше не запускатиме відповідне попередження:

../../../_images/typed_gdscript_warning_system_ignore.webp

Щоб проігнорувати кілька попереджень у регіоні у файлі, використовуйте анотації @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 як помилку:

../../../_images/typed_gdscript_warning_system_errors.webp