輸出面板

輸出面板位於畫面下方，點擊 輸出 標籤即可開啟。

輸出面板提供多項功能，方便瀏覽專案（與編輯器）輸出的文字訊息。

備註

預設情況下，執行專案時輸出面板會自動開啟。你可在 執行 > 下方面板 > 執行時動作 的編輯器設定中調整此行為。

訊息分類

訊息分為四個類型：

• Log： 專案列印的標準訊息。顯示為白色或黑色（依編輯器主題而定）。

• Error: Messages printed by the project or editor that indicate a failure of some kind. Displayed in red.

• Warning: Messages printed by the project or editor that report important information, but do not indicate a failure. Displayed in yellow.

• Editor： 編輯器自身輸出的訊息，通常記錄還原/重做操作。顯示為灰色。

訊息篩選

點擊右側按鈕可隱藏特定訊息類型，方便檢視你要找的訊息。

也可在輸出面板下方的 訊息篩選 輸入框過濾特定文字內容。

清除訊息

預設情況下，執行專案時會自動清除舊訊息。你可在 執行 > 輸出 > 執行時總是清空輸出 中調整此行為。也可以點擊輸出面板右上角的「清除」圖示手動清空訊息。

列印訊息

有多種方法可列印訊息：

• print()：列印訊息。可接受多個參數並串接輸出。

• print_rich()：功能同 print()，但可用 BBCode 標記格式化輸出文字（詳見下方）。

• push_error()：列印錯誤訊息。於執行中的專案呼叫時，訊息會顯示於 除錯器 > 錯誤 分頁。

• push_warning()：列印警告訊息。於執行中的專案呼叫時，訊息會顯示於 除錯器 > 錯誤 分頁。

若需進階格式化功能，可搭配 GDScript 格式化字串 與上述印出函式一同使用。

輸出富文本

使用 print_rich() 可將富文本（BBCode 標記）印出至編輯器輸出面板及標準輸出（從終端機執行專案時可見）。這會將 BBCode 轉換為終端機可理解的 ANSI 控制碼。

於編輯器輸出面板，所有 BBCode 標籤都可正常顯示。在終端機輸出時，僅部分 BBCode 標籤有效，詳情請見上述 print_rich() 方法說明。終端機顏色會依你主題而異，編輯器則與專案內一致。

備註

各種終端機模擬器對 ANSI 控制碼的支援度不一。Windows 僅有 Windows 10 以上的預設終端機支援顯示 ANSI 控制碼。

終端機輸出實際顏色也取決於使用者所選主題。