GDScript警告システム

GDScript警告システムは静的型付けを補完します(しかし、これは静的型付けなしでも働きます)。これはコーディング中に発見しにくく、ランタイムエラーにつながる可能性のあるミスを回避するのに役立ちます。

プロジェクト設定 の GDScript というセクションで警告を設定できます:

注釈

サイドバーに GDScript セクションを表示するには、高度な設定 を有効にする必要があります。高度な設定がオフの場合は、"GDScript" と検索して表示することもできます。

スクリプトエディタのステータスバーにアクティブなGDScriptファイルに関する警告の一覧が表示されます。下の例には2つの警告が出ています:

To ignore single warnings within a file, use the @warning_ignore annotation. You can 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:

To ignore multiple warnings in a region within a file, use the @warning_ignore_start and @warning_ignore_restore annotations. You can omit @warning_ignore_restore if you want to ignore the specified warning types until the end of the file.

警告によってゲームの実行が妨げられることはありませんが、必要に応じて警告をエラーにすることができます。こうすると、すべての警告を修正しない限りゲームはコンパイルされません。このオプションをオンにするには、プロジェクト設定の GDScript セクションに移動して、必要な警告を表示するこのオプションをオンにします。以下の例は前の例と同じファイルで、警告 unused_variable がエラーとする設定になっています。