Community编程与开发github.com

Godot 性能优化 (4.7)

查找并修复 Godot 4.7 中的性能问题——分析器和监视器、帧预算、用于数千个对象的 MultiMesh 和服务器 API、WorkerThreadPool 和线程组、GDScript/C# 热路径、绘制调用、灯光、LOD、物理开销、加载和内存泄漏。当游戏卡顿、FPS 低、加载慢或内存增长时使用。

Godot 性能优化 (4.7) 是什么?

该技能为使用 Godot 4.7 的开发者提供了全面的性能优化指南。它涵盖了所有主要平台(移动端、网页端、桌面端和控制台)以及 Godot 4.7 中可用的工具,包括编辑器调试器中的分析器、Visual Profiler、Monitors 和 ObjectDB 快照(用于检测内存泄漏)。技能详细阐述了 CPU 优化策略,例如禁用不必要的处理、使用 @onready 缓存节点、将 StringName 用于操作/组,以及使用类数组/结构体(而非节点)来处理数千个对象。它还介绍了线程处理,使用 WorkerThreadPool 进行并行任务,以及用于并行子树处理的线程组,并提供了跨线程通信的指导。在 GPU 方面,技能建议减少绘制调用(合并静态网格体、共享材质)、优化光照和阴影、使用 LOD 和遮挡剔除。此外,还涵盖了加载与内存管理(预加载与延迟加载、资源缓存和 VRAM 压缩)。最后,它比较了 GDScript 与 C# 的性能,并针对不同平台给出了经验性的预算建议。

兼容平台~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 与 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 帧。使用它们来分析帧时间尖峰。
  • 命令行:--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 与 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.

相关技能