Godot 性能优化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-performance-optimization。
技能介绍
要解决什么问题
Godot 项目一旦帧时间不稳,常见误判是「先改物理、先合批」——在没有 Time / Memory / Physics 等 Profiler 数据的情况下动刀,往往会卡在错误的瓶颈上。另一个典型情况是:离屏敌人仍在 set_process(true)、get_node() 在每帧热路径里重复遍历、热循环里 Bullet.new() 堆出上千次分配,或 Compatibility 渲染器首帧未 pre-warm 管线导致卡顿。
技能如何工作
本技能以 Debug → Profiler(F3) 为入口,按症状而非「全量加载」选用脚本与模式:
- Time 热点:对象池(
object_pool_system.gd)、@onready缓存节点引用,避免在_process()里get_node() - 离屏逻辑浪费 CPU:
VisibleOnScreenNotifier2D+manual_culling_logic.gd在screen_exited时set_process(false) - Physics 尖峰:用
low_level_physics_query.gd做 space-state 查询,替代大量 RayCast 节点 - GPU / draw call:
multimesh_optimizer.gd、texture_array_batching.gd;必要时rendering_server_direct.gd绕过 SceneTree 开销 - 主线程 hitch:
worker_thread_pool_manager.gd把重计算移出同步路径 - 内存爬升:
shared_resource_strategy.gd与孤儿节点排查
文档还用 NEVER 清单固化反模式:正式版不用 print() 每帧打日志、物理步内不用 call_deferred 以外的树修改、桌面 S3TC/BPTC、移动端 ETC2 纹理压缩(像素风需关压缩)等。
适用边界与注意点
优化脚本应按 Profiler 决策树 按需加载,不要为一次 hitch 把所有 perf 脚本塞进上下文。Navigation 人群抖动应对 navigation_agent_optimization.gd,不要把未整理的 path 队列片段当标准答案。更深主题(Compatibility shader pre-warm、VRAM 表、path time-slicing)在 profiler-budgets-and-prewarm.md 中按需展开。需先具备场景树、@onready 与资源归属基础(见前置技能 godot-project-foundations、godot-gdscript-mastery)。
使用场景
- 二 Week 用 Profiler 的 Time 页锁定某个 `_process` 脚本过热,需要按技能表选用对象池与 `@onready` 缓存方案
- 大量弹丸或敌人在每帧 `instantiate`,要在不改变玩法的前提下用对象池替换热循环里的 `new()`
- Physics 页出现碰撞尖峰,想把成百个 RayCast 节点改成 space-state 低级查询
- Compatibility 渲染器首进场景明显掉帧,需要按文档做 shader 管线 pre-warm 与 VRAM 压缩策略
适合人员
- 独立用 Godot 做 2D/3D 项目、帧率掉到目标以下却找不到 Profiler 证据的独立开发者
- 技术负责人要在发版前根据 Time/Memory/Physics 分项给程序组分配优化任务而非口头猜瓶颈
- 负责移动端移植的工程师,需要把桌面纹理压缩与离屏 `set_process` 剔除写进性能预算
- 做开放世界或大量植被的场景 TA,需要 MultiMesh、Texture2DArray 合批与 RenderingServer 直连降低 draw call