游戏引擎 / 系统课时
处理资源释放不及时
处理资源释放不及时
关卡已经离开而内存仍偏高,可能是节点未释放,也可能是资源仍被缓存或全局对象引用。本课分别检查这两类生命周期,用弱引用和真实资源缓存例程验证最后引用释放后的行为。
学习目标
- 能区分 Node 释放与 RefCounted 资源引用释放
- 能用持有者清单和重复切换定位持续增长
不同对象有不同释放方式
Node 不会因为一个变量被置空而自动销毁,通常用 queue_free 在帧末释放;移出树也不等于释放对象。Resource 继承 RefCounted,GDScript 中最后一个强引用释放后可销毁;资源内部还能引用其他资源,引用链也必须检查。
Godot 的路径缓存用于复用已加载资源,并不是永不释放的强持有仓库。官方文档明确,资源在所有引用释放后会从缓存移除。真正使资源常驻的可能是业务字典、Autoload、节点属性、PackedScene 或脚本的 preload 常量,不能只怪 load 的缓存。
在 C# 中释放时机还受托管垃圾回收影响,不能把 GDScript 的即时引用计数现象直接套上去。操作系统内存没有立即下降也不能单独证明泄漏;分配器和驱动可能保留空间,应该同时观察对象、引用和重复循环趋势。

用小资源验证缓存退出
保存 temporary.tres,只包含一个基础资源,不依赖图片或导入缓存。
[gd_resource type="Resource" format=3]
[resource]
resource_name = "Temporary"保存完整入口 release.gd,执行 godot --headless --path . --script release.gd。弱引用用于观察存活,不会自己把 Resource 留住。
extends SceneTree
func _initialize() -> void:
var one: Resource = load("res://temporary.tres")
var two: Resource = load("res://temporary.tres")
assert(one != null and one == two)
var weak: WeakRef = weakref(one)
var cache := {"temporary": one} # 这是应用自己的强引用缓存。
one = null
two = null
assert(weak.get_ref() != null)
cache.clear() # 最后强引用解除后,弱引用观察到资源消失。
assert(weak.get_ref() == null)
print("alive=", weak.get_ref() != null, " cached=", ResourceLoader.has_cached("res://temporary.tres"))
quit()预期输出(省略启动横幅):
alive=false cached=false如果把这个资源改为 preload 常量,脚本本身仍持有它时就不满足最后引用释放条件。换成忽略缓存的加载模式也不会消除自己的强引用,还可能生成更多资源副本;它不是清理内存的通用按钮。
按生命周期找残留持有者
选一条进入关卡再返回菜单的路线,重复多次,记录退出后的节点、资源和内存。检查 queue_free 是否实际执行、是否等待帧末,以及是否有移出树后无人管理的节点。远程场景树能找到仍在树里的对象,却看不到所有游离对象。
接着查全局列表、字典、信号回调、未完成任务和池。缓存需要容量、淘汰条件和所有者;保存关卡资源前应知道何时删除。闭包或 Callable 捕获的对象也可能延长相关生命周期,引用计数环需要主动打破,不能期望普通引用计数识别所有环。
对业务缓存添加命中、加入与移除记录,按资源路径排查。若离开场景后缓存项数稳定且属于设计中的常驻集合,可能合理;若每轮加入新键却不移除,先修正管理规则,再优化资源格式。
检查结果时先确保诊断变量本身不再保存资源。例如把 weak.get_ref() 的结果赋给一个长寿命变量,就会重新建立强引用,让释放实验失真;只在需要的作用域内检查它。