游戏引擎 / 系统课时
用调试器找到帧率瓶颈
用调试器找到帧率瓶颈
当游戏帧率下降时,先把异常定位到脚本、物理、渲染或等待,再决定改哪里。本课建立一次可重复的调试器观察流程,留下慢帧位置和候选瓶颈,而不是凭单个帧率数字下结论。
学习目标
- 能选择适合脚本、物理和渲染的分析面板
- 能用固定场景进行一次可复查的瓶颈定位
为一次观察固定条件
准备一个能持续复现掉帧的场景,记录 Godot 4.7.2、渲染器、窗口像素尺寸和当前提交。让角色按固定路线经过战斗区域,先预热一遍,再正式采集。首次出现材质、资源加载与持续运行可能是不同问题,不能混成一个平均值。
先声明目标:例如希望以每秒六十帧呈现,单帧预算约十六点六七毫秒。这是目标换算,不是设备成绩。记录垂直同步和帧率上限是否开启;被上限压住的 FPS 无法说明还有多少性能余量。
在编辑器按 F6 运行当前场景,或按 F5 运行项目主场景。底部打开 Debugger(调试器),在 Monitors(监视器)观察 FPS、内存、对象和节点数量。重复相同操作,标记尖峰发生时的游戏事件,而不是只截图最后一个平稳画面。
用两个分析器回答不同问题
在 Debugger → Profiler 点 Start,复现后点 Stop,选择尖峰帧查看脚本函数和物理时间。启动采集本身有额外开销,所以应使用短窗口定位,再用关闭分析器的发行构建复核收益。断点暂停会破坏时间数据,定位性能时先关闭断点。
在 Debugger → Visual Profiler 点 Start,分别检查渲染 CPU 与 GPU 图。这个面板不包含脚本和物理 CPU 时间;因此渲染 CPU 很低也不能证明整个 CPU 空闲。当前文档支持三种渲染方法,但 macOS 的 Compatibility 不支持该面板,类别也会随功能和渲染器变化。
如果当前平台没有 GPU 计时结果,明确记为未观测,改用目标设备的图形分析工具或受控对照实验。不要把缺失指标写成零。保持渲染尺寸一致,否则两次图形采集没有可比性。
读取监视器但不误读它
下面是独立的接口检查。新建空项目,保存为 probe.gd,使用该项目目录执行 godot --headless --path . --script probe.gd。可执行文件在命令搜索路径中时才能使用这个短名称;否则填写自己的引擎完整路径。
extends SceneTree
func _initialize() -> void:
call_deferred("probe") # 等待主循环建立后再读取运行指标。
func probe() -> void:
await process_frame
var nodes := int(Performance.get_monitor(Performance.OBJECT_NODE_COUNT))
var memory := int(Performance.get_monitor(Performance.MEMORY_STATIC))
# 这里验证接口可读,不能代表游戏场景的帧率或GPU耗时。
print("monitor_readable=", nodes >= 0 and memory >= 0)
quit()预期输出(省略引擎启动横幅):
monitor_readable=true静态内存指标只是引擎追踪的一部分,不能替代操作系统进程内存或显存。FPS 一类监视器也可能有更新周期;在空项目和 headless 环境读取它们,尤其不能用于声称真实设备达标。
把候选原因变成对照实验
如果脚本时间突出,临时停用已定位的非关键更新;物理突出,则减少无关碰撞;GPU 突出,则保持逻辑不变,降低渲染尺寸或停用某个昂贵效果。每轮只改一个条件,保留修改前后相同路线的记录。
若改动没有改善目标慢帧,恢复该改动,排查等待、资源读盘和首次管线编译。若有改善,也要检查功能是否被删掉:把敌人全部隐藏虽然可能变快,却不是可发布的修复。最终证据应同时包含异常帧、候选指标、单项改动以及关闭采集后的复测结果。
操作范围见 Debugger panel,监视器含义见 Performance。