游戏引擎 / 系统课时
资源引用怎样避免常驻
资源引用怎样避免常驻
一张活动弹窗图片只显示十几秒,却可能因为单例缓存或漏掉释放而常驻整局游戏。本课用 Cocos Creator 3.8 的资源所有权和引用计数,把全局、场景、弹窗资源分开管理,让动态加载的资源在使用结束后有明确的归还动作。
学习目标
- 按使用期限决定资源应由谁持有。
- 正确配对动态资源的
addRef()、decRef()和组件生命周期。 - 识别单例、对象池与异步回调中的长期引用风险。
先确定资源归谁管
resources.load() 能把资源加载进 AssetManager 缓存,但回调里拿到对象,不代表引擎能识别你的业务代码何时不再使用它。资源所有权应当随实际消费场景变化,而不是统一塞进全局字典。
| 资源范围 | 典型资源 | 建议持有者 |
|---|---|---|
| 整局共享 | 通用 UI 图集、基础音效 | 受控的全局资源服务 |
| 单个场景 | 关卡贴图、模型 | 场景静态依赖或场景级管理器 |
| 临时界面 | 活动弹窗图标 | 弹窗组件自身 |

共享资源不是绝对不能常驻,而是必须有理由:复用频繁、占用可控、明确受预算约束。低频的大图、只在某关卡使用的材质和短期活动资源,不宜被全局单例永久保存。
动态引用必须成对管理
引擎能追踪场景、Prefab 等序列化资源之间的静态依赖,却无法完整统计脚本赋值、闭包和单例形成的动态引用。需要跨越加载回调持续使用某个资源时,持有者调用一次 addRef();结束使用时清除组件关联,再执行一次对应的 decRef()。
decRef() 会减少引用计数,并按引擎的释放检查尝试回收。不要把 releaseAsset() 当作通用的“减引用”操作:它直接释放目标资源,可能导致另一个界面正在使用的图片失效。
实现一个自管理的弹窗图标
在 Cocos Creator 3.8 项目里准备 assets/resources/ui/popup-icon.png,将它导入为带 SpriteFrame 子资源的图片。新建弹窗节点与 Sprite 组件,将下列脚本挂在弹窗上,在属性检查器中把 icon 指向该 Sprite。
import { _decorator, Component, Sprite, SpriteFrame, resources } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('PopupIconOwner')
export class PopupIconOwner extends Component {
@property(Sprite)
icon: Sprite | null = null;
private retained: SpriteFrame | null = null;
private disposed = false;
start(): void {
const icon = this.icon;
if (!icon) {
console.warn('[popup] missing Sprite');
return;
}
resources.load('ui/popup-icon/spriteFrame', SpriteFrame, (error, frame) => {
if (error || !frame) {
console.warn('[popup] load failed');
return;
}
// 弹窗已销毁时,迟到的回调不能重新建立长引用
if (this.disposed) return;
frame.addRef();
this.retained = frame;
icon.spriteFrame = frame;
console.log('[popup] acquired');
});
}
onDestroy(): void {
this.disposed = true;
// 先切断界面引用,再归还本组件持有的一次引用
if (this.icon) this.icon.spriteFrame = null;
if (this.retained) {
this.retained.decRef();
this.retained = null;
console.log('[popup] released');
}
}
}预期输出(资源成功加载后再销毁弹窗节点):
[popup] acquired
[popup] released如果配置缺失或加载失败,会输出对应的警告,不会虚构一次成功加载。弹窗销毁前加载回调尚未完成时,也不会执行 addRef();但该资源仍可能留在加载缓存中,需要结合是否共享和后续复用决定是否额外清理。
处理不会销毁的持有者
node.active = false 只是隐藏或停用节点,不会触发 onDestroy();对象池把弹窗放回池里时同样如此。若池长期保存组件,上述代码的引用也会留在内存里。此时应明确选择:保留小规模可复用资源并限制池容量,或者在“归还池”时主动清空显示引用并 decRef(),下次使用再加载,且防止重复释放。
全局服务只应缓存确实需要跨场景复用的资源,并记录获取、归还和淘汰时机。异步加载完成时还要再次检查请求发起者是否存活;切场景后才返回的结果不能偷偷写回全局缓存。
验证引用有没有越积越多
多次打开并销毁同一个弹窗,核对每次成功加载都对应一次释放日志;再在真机上比较重复操作后的稳定内存。若两次弹窗共用一张图片,各持有者分别 addRef() 和 decRef(),资源只有在不再被其他依赖使用时才适合回收。
资源能否及时退出内存,取决于谁拥有它、何时归还它,以及是否仍有其他使用者。把这三件事落实到组件的生命周期,往往比增加一套复杂的全局清理器更可靠。