Agent Skills
返回列表
💻

Godot 性能优化

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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