GDScript 警告系統

GDScript 警告系統能完善 靜態型別 （但即使不使用靜態型別也能運作）。這個系統可以協助你在開發過程中發現難以察覺的錯誤，避免這些錯誤在執行時發生。

你可以在「專案設定」中的 GDScript 分類下設定警告選項：

備註

必須啟用 進階設定，才能在側邊欄看到 GDScript 分類。若未啟用進階設定，也可以直接搜尋「GDScript」。

在腳本編輯器的狀態列上可以看到目前開啟的 GDScript 檔案所產生的警告。下方範例中有兩個警告：

若要在檔案中忽略單一警告，可以使用 @warning_ignore 標註。你也可以點擊警告描述左側的忽略連結，Godot 會自動在對應行上方加入標註，該程式碼就不會再觸發該警告：

若要在檔案內的某個區塊忽略多個警告，可以使用 @warning_ignore_start 及 @warning_ignore_restore 標註。如果想要忽略直到檔案結尾，可以省略 @warning_ignore_restore。

警告並不會阻止遊戲執行，但你可以選擇將警告視為錯誤。如此一來，除非修正所有警告，否則專案將無法編譯。在「專案設定」的 GDScript 分類找到你想要設定的警告類型，並啟用將此警告視為錯誤的選項。下方範例是將 unused_variable 警告設為錯誤後的畫面：