Community程式設計與開發github.com

Godot 效能 (4.7)

尋找並修復 Godot 4.7 中的效能問題 – 效能剖析器與監控器、畫面幀預算、針對大量物件的 MultiMesh 與伺服器 API、WorkerThreadPool 與執行緒群組、GDScript/C# 熱點、繪製呼叫、光源、LOD、物理成本、載入與記憶體洩漏。當遊戲卡頓、FPS 過低、載入緩慢或記憶體持續增長時使用。

Godot 效能 (4.7) 是什麼?

此技能文件提供了一套全面的 Godot 4.7 效能最佳化指南,重點在於**先測量再最佳化**。它詳細介紹了如何使用編輯器偵錯工具的效能剖析器、視覺化剖析器、監控器以及原生剖析器(Tracy、Perfetto、Apple Instruments)來定位 CPU 與 GPU 的瓶頸。技能涵蓋了常見的效能問題區域,包括:減少不必要的處理程序、利用 MultiMesh 與 RenderingServer 等資料導向技術管理數千個物件、透過 WorkerThreadPool 和執行緒群組安全地執行多執行緒運算、最佳化繪製呼叫與陰影以減輕 GPU 負擔、以及使用 ResourceLoader 與 VRAM 壓縮來管理載入與記憶體。它也比較了 GDScript 與 C# 在不同情境下的取捨,並針對行動裝置、網頁與桌機平台提供了經驗法則預算。最後,技能附帶了來自其「references/patterns.md」檔案的可運作範例,展示了效能 HUD、自訂監控器、MultiMesh 群眾動畫、平行群組任務以及無節點伺服器端子彈等實作模式。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EL4CTEO/godot-skills/tree/main/skills/godot-performance

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

效能 (4.7)

先測量。 絕不要盲目最佳化。每個畫面的預算為 16.6 毫秒 (60 FPS) 或 8.3 毫秒 (120 FPS),涵蓋腳本、物理、渲染的 CPU 與 GPU 時間。

工具

  • 編輯器偵錯器:效能剖析器 (腳本函式;啟動它,開始遊玩,然後依自身時間排序)、視覺化剖析器 (CPU vs GPU 各渲染階段)、監控器 (FPS、處理/物理時間、物件、節點、孤兒節點、繪製呼叫、視訊記憶體)、網路剖析器,以及 ObjectDB 快照 (4.6+:比對兩個快照以找出洩漏)。
  • 程式碼:Performance.get_monitor(Performance.TIME_PROCESS)、RENDER_TOTAL_DRAW_CALLS_IN_FRAME、OBJECT_NODE_COUNT、OBJECT_ORPHAN_NODE_COUNT。使用 Performance.add_custom_monitor(&"game/enemies", callable) 自行新增。
  • 原生剖析器 (4.6+):Tracy、Perfetto (Android 預設) 與 Apple Instruments 可檢視 GDScript、C# 與 GDExtension 影格。用於分析畫面幀時間尖峰。
  • CLI:--profiling、--gpu-profile、--print-fps、--benchmark。使用 --fixed-fps 60 --quit-after N 進行可重複的執行。
  • 洩漏:孤兒節點是從場景樹中移除但從未釋放的節點。Node.print_orphan_nodes()、get_orphan_node_ids() (4.5+)。

CPU:減少工作量

  • 停用不需要的處理程序:閒置時使用 set_process(false)/set_physics_process(false)。VisibleOnScreenEnabler2D/3D 可暫停畫面外的角色。計時器比逐幀輪詢更佳。
  • 逐幀程式碼是熱點路徑。快取節點至 @onready/_Ready。對動作、群組與方法名稱使用 StringName 字面值 (&"jump")。不要每幀都呼叫 get_tree().get_nodes_in_group()。使用型別化的 GDScript (型別化操作碼更快)。
  • 訊號與 call_group 對於事件而言成本低廉,但不要針對數千個實體逐實體、逐幀地發射它們。
  • 數千個物件: 停止對每個物件使用一個節點。
    • 視覺:MultiMeshInstance3D/2D (單一繪製呼叫;批次寫入 multimesh.buffer),或 GPU 粒子。
    • 邏輯:在一個管理腳本中使用純陣列與結構 (資料導向),而不是每個實體一個腳本。
    • 物理:使用 PhysicsServer2D/3D 的剛體與碰撞區域 (無需節點),或每幀批次執行一次射線檢測。
    • 無節點渲染:RenderingServer 的實例與畫布項目。
  • 物理:除非遊戲需要,否則將 physics_ticks_per_second 保持為 60。使用簡單的原始形狀,並避免在移動的剛體上使用 ConcavePolygonShape3D。使用圖層與遮罩來減少配對檢查。讓剛體休眠 (can_sleep)。

執行緒

  • WorkerThreadPool.add_task(callable) / add_group_task(callable, count) (平行 for 迴圈),然後 wait_for_task_completion(id)。對大多數工作而言,這比原始的 Thread 更好。
  • 場景樹規則:除非節點位於執行緒群組中 (process_thread_group = PROCESS_THREAD_GROUP_SUB_THREAD,它會平行處理該子樹,並使用 call_deferred_thread_group 進行跨群組呼叫),否則場景樹內的節點只能由主執行緒存取。從工作執行緒中,使用 call_deferred / Callable.call_deferred() 將結果傳回。使用 Thread.is_main_thread() 進行斷言 (4.7)。
  • 共享資料:使用 Mutex 保護,或讓每個工作者擁有自己的切片,然後在主執行緒上合併。
  • 背景載入:ResourceLoader.load_threaded_request(path, "", true) 使用子執行緒處理依賴項。

GPU 與渲染

  • 繪製呼叫:合併靜態網格並共用材質,因為網格表面上的每個獨特材質都會增加呼叫次數。對重複物件使用 MultiMesh,在 2D 中使用紋理圖集。
  • 光源與陰影通常是 GPU 的耗能大戶。使用少量的陰影點光源與聚光燈,保持 directional_shadow_max_distance 較小,並烘焙靜態光照 (LightmapGI)。
  • 過度繪製:大型的半透明粒子與全螢幕 Alpha。對樹葉使用 Alpha 裁切或雜訊,並使用較小的粒子四邊形。
  • 細節縮放:LOD (mesh_lod_threshold)、visibility_range_*、遮擋剔除,以及在弱 GPU 上使用解析度縮放 (FSR、MetalFX)。為低階裝置選擇正確的渲染器:Mobile 或 Compatibility (請參閱 godot-3d-rendering)。
  • 著色器卡頓:著色器烘焙 (匯出選項)、更少的材質變體。

載入與記憶體

  • preload 會在腳本載入時載入並阻塞。僅對你總是需要的少量內容使用它。load 是惰性的。執行緒載入適用於關卡。
  • ResourceLoader 會快取資源。重複使用它們,除非你需要每個實例的狀態,否則不要 duplicate() 共享資源。
  • 紋理:VRAM 壓縮匯入 (3D 預設;為大型 2D 啟用)。3D 使用 Mipmap。每個平台限制最大尺寸。音訊:長音軌使用 Ogg 串流。
  • 釋放你生成的內容:對子彈使用 queue_free() 和物件池。監控孤兒節點數量保持平穩。

GDScript vs C#

  • GDScript 對於遊戲邏輯來說已經足夠。將密集的數學迴圈 (尋路、程序化生成、模擬) 移至 C# 或 GDExtension,並仍然批次處理 API 呼叫。
  • C#:避免逐幀分配 (LINQ、閉包、字串格式化、new Godot.Collections.Array)。每次 Godot API 呼叫都會跨越互通邊界,因此請批次處理它們。Packed 陣列在跨越邊界時會複製。

平台預算 (經驗法則)

行動裝置:< 100–150 個繪製呼叫、1 個陰影光源、Mobile 或 Compatibility 渲染器、30–60 FPS 目標。網頁:Compatibility 渲染器、單執行緒 (除非匯出使用執行緒,則需要跨來源隔離標頭),並保持下載量小。桌機或主機:Forward+,在最低規格硬體上進行效能剖析。

效能 HUD + 自訂監控器、MultiMesh 人群、平行群組任務、伺服器端子彈 (由測試編譯):references/patterns.md

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能