性能优化 (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