Up to date

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

GDScript 警告系統

GDScript 警告系統可與 靜態型別 互補 (但即使不用靜態型別也能使用警告系統)。警告系統能幫助開發者避免一些在開發時期難以找出的問題,這些問題隨後可能會在執行時產生錯誤。

可以在「專案設定」的 Gdscript 分類下設定警告:

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

備註

You must enable Advanced Settings in order to see the GDScript section in the sidebar. You can also search for "GDScript" when Advanced Settings is off.

You can find a list of warnings for the active GDScript file in the script editor's status bar. The example below has 2 warnings:

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

To ignore specific warnings in one file, insert an annotation of the form @warning_ignore("warning-id"), or click on the ignore link to the left of the warning's description. Godot will add an annotation above the corresponding line and the code won't trigger the corresponding warning anymore:

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

Warnings won't prevent the game from running, but you can turn them into errors if you'd like. This way your game won't compile unless you fix all warnings. Head to the GDScript section of the Project Settings to turn on this option to the warning that you want. Here's the same file as the previous example with the warning unused_variable as an error turned on:

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