游戏引擎 / 系统课时
释放不用的资源引用
释放不用的资源引用
连续进入战斗、返回大厅后,敌人虽已消失,内存仍可能持续上涨。问题常在于动态加载的 Prefab、材质或纹理仍被持有。本课以守卫为例,完成加载、实例化、解除引用的闭环,判断何时可以安全释放。
学习目标
- 区分节点销毁、脚本引用置空与引擎资源释放。
- 正确配对
addRef、decRef,回收不再使用的动态资源。 - 按引用关系排查反复切场景后的资源滞留。
先分清三种不同的清理
Node.destroy() 负责销毁场景对象,却不等于把其关联的 Prefab、纹理、材质立即从缓存里全部清除。把变量设为 null 只会移除脚本持有的 JavaScript 引用,也不是让资源管理器直接释放 GPU 数据。
Cocos Creator 3.8 会缓存已加载资源,并追踪资产之间的静态依赖;但脚本动态保存的长期引用需要自己管理。对某个动态资产调用 addRef() 表示“我还要用”,不用时配对 decRef(),引擎才有机会根据引用计数及依赖情况执行自动释放。
| 操作 | 作用 | 常见误区 |
|---|---|---|
node.destroy() |
销毁场景实例 | 误以为资源缓存同步清空 |
asset.addRef() |
增加自己持有的资源引用 | 添加后忘记归还 |
asset.decRef() |
归还一次手动增加的引用并尝试自动释放 | 误以为任何共享依赖都会立刻消失 |
assetManager.releaseAsset(asset) |
显式释放指定资产 | 在仍被其他对象使用时强行释放 |
资源的使用周期
以 Guard.prefab 为例:资源加载后进入缓存,脚本先获取一份引用,再实例化守卫;守卫退场时销毁节点并归还自己增加的引用。若另一个场景还需要同一份资源,其依赖可能继续保留。

场景切换前尤其要检查常驻管理器、对象池、全局数组和事件订阅:它们可能仍持有战斗资源。共享素材先明确所有者,再决定何时释放,不要根据“屏幕上看不见”推断资源无人使用。
动态加载并配对释放
在 assets/resources/prefabs/Guard.prefab 准备一个 Prefab,并在测试场景放置 EnemyHost 节点,挂载下面的 EnemyResourceDemo.ts。示例加载 Prefab、实例化子节点,两秒后销毁实例并归还引用;组件因切场景提前销毁时也会执行清理。
import {
_decorator, Component, Node, Prefab,
instantiate, isValid, resources,
} from 'cc';
const { ccclass } = _decorator;
@ccclass('EnemyResourceDemo')
export class EnemyResourceDemo extends Component {
private prefab: Prefab | null = null;
private instance: Node | null = null;
start() {
resources.load('prefabs/Guard', Prefab, (err, loaded) => {
if (err || !loaded) {
console.error('Guard 加载失败', err);
return;
}
// 异步回调到达时,本组件可能已随旧场景销毁
if (!isValid(this.node)) return;
loaded.addRef();
this.prefab = loaded;
this.instance = instantiate(loaded);
this.instance.setParent(this.node);
console.log('已创建 Guard');
this.scheduleOnce(() => {
this.releaseEnemy();
console.log('已归还 Guard 的资源引用');
}, 2);
});
}
private releaseEnemy() {
if (this.instance && isValid(this.instance)) {
this.instance.destroy();
}
this.instance = null;
if (this.prefab) {
this.prefab.decRef();
this.prefab = null;
}
}
onDestroy() {
// 场景提前退出时,仍须归还自己增加的引用
this.releaseEnemy();
}
}预期输出(资源路径存在且场景持续运行至少两秒):
已创建 Guard
已归还 Guard 的资源引用层级中的 Guard 实例会先出现,再被销毁;这两行日志只证明清理路径已执行,不等于证明所有材质与纹理已立即释放。缺少 Prefab 时会进入“Guard 加载失败”分支,应先核对 resources 目录和相对路径。
验证内存是否真的稳定
连续执行“进入战斗→生成敌人→返回大厅”多轮,对比相同阶段的资源数量和内存曲线,避免把首次加载缓存、垃圾回收延迟误判为泄漏。若每轮仍增长,按“活跃节点→常驻对象或对象池→手动增加的引用→资产依赖”的顺序定位。
不要为了让曲线下降直接调用 assetManager.releaseAll()。对于场景静态引用,可结合场景的自动释放设置;对于动态资源,首选管理好每一次 addRef() 与 decRef() 的配对。释放工作的终点不是变量变成 null,而是确认没有其他仍在使用它的所有者。