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 的許多除錯工具都是“除錯器”面板的一部分,你可以在 除錯工具 中找到相關資訊。

測試

在編輯器中運作遊戲時, 有幾個常見的除錯選項可以切換為開或關, 以幫助你除錯遊戲.

您可以在編輯器功能表**除錯**中找到這些選項。

../../../_images/overview_debug.webp

下面是這些選項的說明:

部署並啟用遠端偵錯

當匯出和部署時, 產生的可執行檔將嘗試連接到你的電腦的IP上進行除錯.

使用網路檔案系統進行小型部署

這個選項加快了在遠端裝置上進行大足跡遊戲的測試.

當**使用網路檔案系統進行小型部署**開啟時,部署遊戲不是匯出整個遊戲,而是建立一個最小的可執行檔。然後,編輯器通過網路提供專案中的檔。

另外,在 Android 系統上,遊戲採用 USB 線部署,加快部署速度。

顯示碰撞區域

這個選項使碰撞形狀和射線傳輸節點在運作的遊戲中可見.

顯示導覽

可以在運作的遊戲的時候看到導覽網格和多邊形.

同步場景改動

使用此選項, 在運作時對編輯器中的場景所做的任何更改都會立即顯示. 當在裝置上遠端使用時, 這對網路檔案系統來說更為有效.

同步腳本改動

任何被保存的腳本都會被重新載入到正在運作的遊戲上. 當在裝置上遠端使用時, 這對網路檔案系統來說更有效率.

腳本編輯器除錯工具和選項

腳本編輯器有自己的一套除錯工具,用於中斷點和兩個選項。中斷點工具也可以在除錯器的**除錯器**分頁中找到。

小訣竅

您可以透過點選腳本編輯器左側的裝訂線(行號左側)來建立斷點。將滑鼠懸停在該排水溝上時,您會看到出現一個透明的紅點,點擊放置斷點後,該紅點會變成不透明的紅點。再次點選紅點即可刪除斷點。以這種方式建立的斷點在編輯器重新啟動後仍然存在,即使退出編輯器時未儲存腳本也是如此。

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.

../../../_images/overview_script_editor.webp

中斷點 按鈕會像中斷點一樣導致腳本的中斷. 繼續 使遊戲在中斷點處暫停後繼續. Step Over 進入下一行程式碼, 如果可能的話, Step Into 進入一個函式. 否則, 它與 Step Over 做同樣的事情.

Keep Debugger Open 選項可以使除錯器在關閉場景後保持打開狀態。而 Debug with External Editor 選項可以讓你用外部編輯器除錯遊戲。

當偵錯器在斷點處中斷時,腳本編輯器的裝訂線中會顯示綠色三角形箭頭。此箭頭指示偵錯器中斷的程式碼行。

測試

在專案設定中有一個 **Debug**(除錯)類別,包含三個子類別別,可以控制不同的東西。

設定

這些都是一些常規的設定,比如將目前的 FPS 列印到**輸出**面板,剖析時的最大函式量等。

GDScript

這些設定允許你切換特定的GDScript警告, 比如未使用的變數. 您也可以完全關閉警告.

形狀

Shapes中你可以調整形狀的顏色, 這些形狀只出現在除錯的目的, 如碰撞和導覽形狀.

遙控場景面板

當在編輯器中運作遊戲時,場景**面板頂部會出現兩個選項,即**遠端**和**本地。當使用**遠端**時,你可以檢查或改變運作專案中的節點參數。

../../../_images/overview_remote.webp

備註

一些與除錯有關的編輯器設定可以在 Editor Settings 內找到, 在 Network > Debug and Debugger 部分.