效能 (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