Up to date
This page is up to date for Godot 4.2
.
If you still find outdated information, please open an issue.
除錯工具概述¶
本指南將概述引擎中可用的除錯工具.
Godot自帶強大的除錯器和剖析器, 可以追蹤bug, 在運作時檢查你的遊戲, 監控重要指標, 並測量性能. 它還提供了在運作遊戲中視覺化碰撞框和導覽多邊形的選項.
最後, 你可以選擇除錯在遠端裝置上運作的遊戲, 並在遊戲運作時重新載入對你的場景或程式碼的修改.
除錯工具¶
Godot 的許多除錯工具都是“除錯器”面板的一部分,你可以在 除錯工具 中找到相關資訊。
腳本編輯器除錯工具和選項¶
腳本編輯器有自己的一套除錯工具,用於中斷點和兩個選項。中斷點工具也可以在除錯器的**除錯器**分頁中找到。
小訣竅
您可以透過點選腳本編輯器左側的裝訂線(行號左側)來建立斷點。將滑鼠懸停在該排水溝上時,您會看到出現一個透明的紅點,點擊放置斷點後,該紅點會變成不透明的紅點。再次點選紅點即可刪除斷點。以這種方式建立的斷點在編輯器重新啟動後仍然存在,即使退出編輯器時未儲存腳本也是如此。
You can also use the breakpoint
keyword in GDScript to create a
breakpoint that is stored in the script itself. Unlike breakpoints created by
clicking in the gutter, this keyword-based breakpoint is persistent across
different machines when using version control.
中斷點 按鈕會像中斷點一樣導致腳本的中斷. 繼續 使遊戲在中斷點處暫停後繼續. Step Over 進入下一行程式碼, 如果可能的話, Step Into 進入一個函式. 否則, 它與 Step Over 做同樣的事情.
Keep Debugger Open 選項可以使除錯器在關閉場景後保持打開狀態。而 Debug with External Editor 選項可以讓你用外部編輯器除錯遊戲。
當偵錯器在斷點處中斷時,腳本編輯器的裝訂線中會顯示綠色三角形箭頭。此箭頭指示偵錯器中斷的程式碼行。
測試¶
在專案設定中有一個 **Debug**(除錯)類別,包含三個子類別別,可以控制不同的東西。
設定¶
這些都是一些常規的設定,比如將目前的 FPS 列印到**輸出**面板,剖析時的最大函式量等。
GDScript¶
這些設定允許你切換特定的GDScript警告, 比如未使用的變數. 您也可以完全關閉警告.
形狀¶
Shapes中你可以調整形狀的顏色, 這些形狀只出現在除錯的目的, 如碰撞和導覽形狀.
遙控場景面板¶
當在編輯器中運作遊戲時,場景**面板頂部會出現兩個選項,即**遠端**和**本地。當使用**遠端**時,你可以檢查或改變運作專案中的節點參數。
備註
一些與除錯有關的編輯器設定可以在 Editor Settings 內找到, 在 Network > Debug and Debugger 部分.