Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

疑難排解

本頁列出了在使用 Godot 時會遇到的場景問題與可行的解決方案。

也參考

關於 Godot 編輯器 HTML5 版本的特定注意事項,請參考 執行編輯器

編輯器運作緩慢,佔用了我所有的 CPU 和 GPU 資源,使我的電腦變得嘈雜

這是一個已知問題,尤其是在 macOS 上,因為大多數 Mac 都有 Retina 顯示幕。由於 Retina 顯示器的像素密度更高,因此所有內容都必須以更高的解析度渲染。這會增加 GPU 上的負載並降低感知性能。

有幾種衡量性能和電池續航的方法, 包括:

  • 在 3D 模式下,按一下左上角的 透視 按鈕並啟用 半解析度 。現在 3D 視口就會以半解析度渲染,速度最多可以提高到原來的 4 倍。

  • 打開編輯器設定並將 節能處理器模式睡眠(微秒) 的值增加到 33000 (30 FPS)。 該值確定要渲染的影格之間的 微秒 量。 較高的值將降低編輯器反應性,但可顯著降低 CPU 和 GPU 使用率。

  • 如果您有某個節點導致編輯器連續重新繪製(例如粒子),請將其隱藏並使用 _ready() 方法在腳本中顯示它。這樣,它將隱藏在編輯器中,但仍在正在運作的專案中可見。

編輯器在我的可變更新率顯示器(G-Sync/FreeSync)上出現卡頓和閃爍的情況

這是一個 已知問題 。 可變更新率顯示器需要不斷調整其伽瑪曲線,以便隨著時間的推移發出一致的光量。 當更新率變化很大時,這可能會導致圖像的黑暗區域出現閃爍,這是因為 Godot 編輯器僅在必要時重繪。

這有幾種解決辦法:

  • 在編輯器設定中啟用 介面 > 編輯器 > 持續更新 。 現在即使螢幕沒有變化,編輯器也將不斷渲染,這會增加功耗、造成熱量和噪音的更大排放。 為了緩解這種情況,你可以在編輯器設定中將 節能處理器模式睡眠(微秒) 增加到 33000 (30 FPS)。 該值確定要渲染的影格之間的 微秒 量。 較高的值將降低編輯器反應性,但可顯著降低 CPU 和 GPU 使用率。

  • 或者,在顯示器或圖形驅動程式中禁用可變更新率。

  • VRR閃爍這個問題在某些顯示器上,可以通過你的顯示器的OSD中的**VRR控制**或**微調暗區**選項來減少。這些選項可能會增加輸入延遲或導致黑色失真。

  • 如果使用一台OLED顯示器,可以在編輯器設定中使用**黑色(OLED)**預設。因為OLED顯示器的出色的黑階表現,這個預設將會有助於減弱VRR閃爍。

編輯器或專案花了很多時間才打開

當使用基於Vulkan的渲染器(Forward+ 或 Forward Mobile)時,第一次啟動將會話費比較長的時間。這是因為著色器需要在快取之前進行編譯。更新Godot、更新顯卡驅動或切換顯卡後,著色器也需要重新快取。

這是在 Windows 上的一個 已知 Bug ,會發生在有連接到特定 USB 週邊裝置時。特別是 Corsair 的 iCUE 軟體似乎會導致這個問題。請試著更新這些 USB 週邊裝置的驅動程式至最新版本。若仍然遇到此 Bug,則必須在開啟編輯器時先斷開有問題的週邊裝置。開啟後即可重新接上。

Firewall software such as Portmaster may also cause the debug port to be blocked. This causes the project to take a long time to start, while being unable to use debugging features in the editor (such as viewing print() output). You can work this around by changing the debug port used by the project in the Editor Settings (Network > Debug > Remote Port). The default is 6007; try another value that is greater than 1024, such as 7007.

點擊系統主控台後,Godot 編輯器沒有回應

在 Windows 上啟用系統主控台時執行 Godot,可能會不小心在命令視窗內因點擊而啟用了 選擇模式 。這個行為只會發生在 Windows 上,會暫停應用程式來讓使用者可選擇系統主控台內的文字。Godot 無法複寫此一系統特定的行為。

要解決此問題,請選擇系統主控台視窗,並按一下 Enter 鍵來離開選擇模式。

手動移動Godot編輯器的macOS dock 圖示之後,會出現多餘的編輯器圖示

如果你打開 Godot 編輯器並手動改變 dock 圖示的位置,然後重啟編輯器,你會在 dock 的最右邊看到一個重複的 dock 圖示。

這是由於 macOS dock 的設計限制造成的。解決這個問題的唯一已知方法是將專案管理器和編輯器合併為一個程序,這意味著專案管理器在啟動編輯器時不再產生一個單獨的程序。雖然使用單一程序實例會帶來一些好處,但由於工作的複雜性,完成這個功能沒有列入我們近期的工作計畫。

為了避免這個問題,保持 Godot 編輯器的 dock 圖示在 macOS 建立的預設位置。

在專案管理員與編輯器視窗左上角出現"NO DC"之類的文字

這是由於NVIDIA顯卡驅動程式注入了覆蓋顯示資訊造成的。

要在Windows上禁用此覆蓋,請在NVIDIA控制台中將圖形驅動程式設定恢復為預設值。

要在Linux上禁用此覆蓋,請打開``nvidia-settings``,轉到**X Screen 0 > OpenGL Settings**,然後取消選中**Enable Graphics API Visual Indicator**。

編輯器或專案顯示看起來過於銳利或模糊

正確的外觀(左),由於顯卡驅動的銳化而導致的過度銳化的外觀(右)

正確的外觀(左),由於顯卡驅動的銳化而導致的過度銳化的外觀(右)

如果編輯器或專案看起來過於銳利,這可能是由於你的圖形驅動程式強制對所有 Vulkan 或 OpenGL 應用程式進行圖像銳化。你可以在圖形驅動程式的控制台中禁用此行為:

  • NVIDIA(Windows): 打開"開始"功能表,選擇“NVIDIA 控制台”。打開左側的**管理 3D 設定**分頁。在中間的列表中,滾動到**圖像銳化**,並將其設定為**關閉銳化**。

  • AMD(Windows):**打開開始功能表,選擇**AMD 軟體。點擊右上角的設定 "齒輪 "圖示。轉到“圖形”分頁,然後禁用“Radeon 圖像銳化”。

如果編輯器或者專案看起來過於模糊,這可