游戏引擎 / 系统课时
处理资源加载与释放
处理资源加载与释放
切换关卡后,旧场景的图片、音效仍可能留在资源缓存中;反过来,过早释放共享贴图又会让新页面显示异常。本课用 Cocos Creator 3.8 管理一张运行时加载的图标,明确谁持有资源、什么时候归还引用,以及如何核对内存变化。
学习目标
- 区分场景节点、动态加载的资源和资源缓存。
- 使用
resources.load()、addRef()与decRef()管理一段完整持有周期。 - 处理异步回调晚到、场景切换和共享资源的释放风险。
先分清节点、资源与缓存
节点是场景中的运行时对象,SpriteFrame、纹理和 Prefab 则是资源对象。node.destroy() 销毁节点及其组件,但不等于强制清空 assetManager 缓存。资源被加载后可能留在缓存中,以便下次快速复用;缓存占用需要结合引用关系与场景释放策略管理。
编辑器内拖入组件属性的是静态引用,引擎能分析序列化的资源依赖。代码中加载资源再赋给 sprite.spriteFrame 属于动态引用,不能假定引擎会自动把这次赋值计入资源引用数。若组件需要持续持有,加载成功后调用 addRef(),不用时配对 decRef()。
资源的加载与归还路径

资源是否能释放,不仅取决于当前节点是否消失,还取决于其他资源、场景或管理器是否继续持有它。decRef() 表示当前持有者放手,随后由引擎检查释放条件;它不是“强制立即清除显存”的命令。
给动态图片成对管理引用
在项目中准备图片 assets/resources/ui/icons/coin.png,确保导入后有 SpriteFrame 子资源。在一个带 Sprite 组件的节点上挂载以下脚本。resources.load() 使用相对 resources 的路径,不包含原图片扩展名;读取图片的 SpriteFrame 子资源时需要以 /spriteFrame 结尾。
import { _decorator, Component, Sprite, SpriteFrame, resources, isValid, log, warn } from 'cc';
const { ccclass } = _decorator;
@ccclass('CoinIconLoader')
export class CoinIconLoader extends Component {
private ownedFrame: SpriteFrame | null = null;
private loadVersion = 0;
onLoad() {
const sprite = this.getComponent(Sprite);
if (!sprite) {
warn('节点缺少 Sprite 组件');
return;
}
const version = ++this.loadVersion;
resources.load('ui/icons/coin/spriteFrame', SpriteFrame, (err, frame) => {
if (err || !frame) {
warn(`图标加载失败: ${err?.message ?? '未返回资源'}`);
return;
}
// 异步回调可能晚于场景卸载,过期请求不得再持有资源。
if (!isValid(this, true) || version !== this.loadVersion) return;
frame.addRef();
this.ownedFrame = frame;
sprite.spriteFrame = frame;
log('金币图标加载完成');
});
}
onDestroy() {
++this.loadVersion;
const sprite = this.getComponent(Sprite);
if (sprite && isValid(sprite, true)) sprite.spriteFrame = null;
// 每次 addRef 对应一次 decRef,避免长期保留动态资源。
if (this.ownedFrame) {
this.ownedFrame.decRef();
this.ownedFrame = null;
log('金币图标引用已归还');
}
}
}预期结果:资源可用时,节点显示金币图标,控制台先出现:
金币图标加载完成若加载完成后销毁该节点或切换离开并销毁其所在场景,随后出现:
金币图标引用已归还如果路径错误,会打印加载失败警告,节点不会显示新图标。若节点已销毁时回调才完成,脚本不会再访问失效组件,也不会新增持有引用;已载入但无人持有的缓存仍由资源管理策略处理。
场景切换和手动释放如何分工
场景资源可配置 Auto Release Assets,让切换场景时处理该场景依赖的资源;对脚本动态持有的资源,则仍要明确 addRef() 和 decRef() 的配对责任。跨场景常驻的 UI 图集或背景音乐,应由寿命更长的管理器持有,等真正不再使用时才归还引用。
assetManager.releaseAsset(asset)、resources.release() 等显式接口会直接释放指定资源,不要仅因旧场景退出就对共享资源盲目调用。本例已经通过引用计数表达所有权,不应紧接 decRef() 再强制释放同一资源。资源之间的依赖由引擎追踪,但代码产生的动态持有关系仍需要业务自行管理。
如何验证加载释放真正生效
先重复进入、退出含金币图标的场景,观察成功与归还日志是否成对出现。再使用目标平台的性能或内存分析工具比较多轮切换后的稳定内存水平,而不是把一次垃圾回收前的瞬时峰值当作泄漏。
如果内存持续抬升,依次确认:销毁回调是否触发;异步回调是否越过销毁继续设置组件;持有者是否漏掉 decRef();是否还有常驻节点或其他资源依赖。若图片始终不显示,首先检查资源路径、/spriteFrame 后缀与导入类型,而不是提前调用释放接口。有关自动与手动释放的边界可参阅 Cocos Creator 3.8:资源释放。