GDScript 警告系統

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

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

Warning system project settings

警告系統專案設定

在腳本編輯器的狀態列上列出了目前開啟中 GDScript 檔案的警告。下方的範例中有三個警告:

Warning system example

警告系統範例

如果要在檔案中忽略特定的警告,可以插入使用 #warning-ignore:警告ID 這種格式的註解,或是點擊警告說明右邊的 [忽略] 連接。Godot 會自動將註解插入對應行,而該程式碼即不會再觸發警告:

Warning system ignore example

警告系統忽略範例

也可以使用 #warning-ignore-all:警告ID 這種格式來在整個檔案內忽略特定類型的警告。如果想在檔案內忽略特定所有警告,請使用 #warnings-disable 註解。

出現警告並不會讓遊戲無法執行,但若有需要可以將警告設定為錯誤。設定為錯誤後,除非修正所有警告,否則遊戲將無法正確編譯。在專案設定中找到 GDScript 分類,然後打開該選項。下列範例為相同的檔案,但將警告顯示為錯誤:

Warnings as errors

設定為錯誤的警告