游戏引擎 / 系统课时
看懂帧率与主线程开销
看懂帧率与主线程开销
3D 场景掉帧时,FPS 只能说明结果,不能直接判断是脚本、物理还是渲染拖慢了一帧。本课用 Godot 4 的 Monitors、Profiler 和 Visual Profiler 建立测量顺序,并用脚本记录耗时,让优化结果可以复测。
学习目标
- 将 FPS 转换为帧时间预算,区分结果指标与耗时来源。
- 使用性能监视器和分析器辨别脚本、物理及渲染压力。
- 在固定测试条件下复测优化效果,避免误判。
用帧预算判断是否真的超时
目标为 60 FPS 时,每帧平均只有约 16.67 ms 的时间预算;30 FPS 对应约 33.33 ms。一次明显卡顿可能只持续几帧,因此只看平均 FPS 会掩盖峰值。还要注意垂直同步、帧率限制与后台窗口节流:FPS 被锁在目标值,不代表 CPU 或 GPU 已满载。
主线程承担脚本与场景逻辑等工作,物理、渲染提交和 GPU 绘制的实际调度并不等于同一条耗时曲线。不能把“FPS 下降”直接翻译成“脚本运行慢”,也不能简单将各类时间相加当成总帧时间。
从监视曲线走到具体热点
- 在相同窗口分辨率、相同相机位置和相同操作路线下运行 3D 场景,先跳过首次资源加载,记录稳定运行与卡顿发生时的表现。
- 打开底部 Debugger > Monitors,观察 FPS、帧处理耗时、物理处理耗时,以及渲染统计的变化。监视数据会按一定间隔更新,不能把单次读数当作瞬时峰值。
- 切换到 Debugger > Profiler 并点击 Start,复现卡顿后定位帧时间峰值,展开脚本函数、Idle 和 Physics 相关条目,比较函数的 Inclusive 与 Self 时间。
- 如果脚本与物理并未解释明显的帧耗时,再打开 Debugger > Visual Profiler,点击 Start,观察渲染任务在 CPU 与 GPU 侧的时间分布,并结合绘制调用和场景效果做验证。

Profiler 不是始终自动采集,未点击 Start 时没有曲线不等于场景没有性能问题。Visual Profiler 主要用于渲染相关开销分析,不能代替脚本或物理分析;不同渲染方式、平台和调试构建的统计项目可能不完全相同。
用 GDScript 定期记录关键指标
在场景的 Node3D 根节点挂载以下脚本,运行场景后每隔约一秒向 Output 输出一次数据。Performance.TIME_PROCESS 与 TIME_PHYSICS_PROCESS 的单位都是秒,乘以 1000 后才方便和毫秒级帧预算对照。
extends Node3D
var sample_elapsed := 0.0
func _process(delta: float) -> void:
sample_elapsed += delta
# 限制打印频率,避免大量日志干扰性能观察。
if sample_elapsed < 1.0:
return
sample_elapsed = 0.0
# 性能监视器的时间单位是秒,这里统一转成毫秒。
var fps := int(Performance.get_monitor(Performance.TIME_FPS))
var frame_ms := Performance.get_monitor(Performance.TIME_PROCESS) * 1000.0
var physics_ms := Performance.get_monitor(Performance.TIME_PHYSICS_PROCESS) * 1000.0
print("FPS=%d, Frame=%.2f ms, Physics=%.2f ms" % [fps, frame_ms, physics_ms])预期输出格式(数值因设备、场景与采样时刻而变):
FPS=<FPS>, Frame=<TIME> ms, Physics=<TIME> ms这里的 Frame 表示引擎监视器记录的帧处理耗时,并非“纯脚本时间”;Physics 对应物理处理周期,也不能不加判断地从 Frame 中相减来推算渲染耗时。示例中的 <FPS> 和 <TIME> 是动态值占位符,实际运行会显示整数及保留两位小数的耗时。
按证据选择第一项优化
| 观察到的变化 | 优先核实的对象 | 可以尝试的单项实验 |
|---|---|---|
| 脚本函数 Self 时间持续偏高 | 高频循环、重复查询、每帧分配 | 缓存引用或将刷新改为按需执行 |
| 物理处理时间随对象数明显上涨 | 碰撞对、检测频率、活动刚体 | 暂时减少活动物理对象进行对照 |
| 帧耗时上升但脚本与物理变化有限 | CPU 渲染任务、GPU 阶段、同步等待 | 保持镜头不变,单独关闭一项昂贵视觉效果 |
先记录基线,再只改变一个因素,并在相同路线重测 FPS、帧耗时峰值与相关热点。若关闭阴影后 GPU 阶段明显下降、脚本时间近似不变,才有证据优先调整阴影;若只降低物理对象数量才改善,则应回头检查碰撞与物理更新。
编辑器的调试器和分析器本身也有开销,最终性能验收仍应在目标设备上用接近发布配置的导出版本复测。能够重复出现的前后差异,比单次最高 FPS 更值得相信。