游戏引擎 / 系统课时

释放不用的资源引用

释放不用的资源引用

连续进入战斗、返回大厅后,敌人虽已消失,内存仍可能持续上涨。问题常在于动态加载的 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 为例:资源加载后进入缓存,脚本先获取一份引用,再实例化守卫;守卫退场时销毁节点并归还自己增加的引用。若另一个场景还需要同一份资源,其依赖可能继续保留。

动态 Prefab 资源从加载到解除引用的生命周期

场景切换前尤其要检查常驻管理器、对象池、全局数组和事件订阅:它们可能仍持有战斗资源。共享素材先明确所有者,再决定何时释放,不要根据“屏幕上看不见”推断资源无人使用。

动态加载并配对释放

在 assets/resources/prefabs/Guard.prefab 准备一个 Prefab,并在测试场景放置 EnemyHost 节点,挂载下面的 EnemyResourceDemo.ts。示例加载 Prefab、实例化子节点,两秒后销毁实例并归还引用;组件因切场景提前销毁时也会执行清理。

ts
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();
  }
}

预期输出(资源路径存在且场景持续运行至少两秒):

text
已创建 Guard
已归还 Guard 的资源引用

层级中的 Guard 实例会先出现,再被销毁;这两行日志只证明清理路径已执行,不等于证明所有材质与纹理已立即释放。缺少 Prefab 时会进入“Guard 加载失败”分支,应先核对 resources 目录和相对路径。

验证内存是否真的稳定

连续执行“进入战斗→生成敌人→返回大厅”多轮,对比相同阶段的资源数量和内存曲线,避免把首次加载缓存、垃圾回收延迟误判为泄漏。若每轮仍增长,按“活跃节点→常驻对象或对象池→手动增加的引用→资产依赖”的顺序定位。

不要为了让曲线下降直接调用 assetManager.releaseAll()。对于场景静态引用,可结合场景的自动释放设置;对于动态资源,首选管理好每一次 addRef() 与 decRef() 的配对。释放工作的终点不是变量变成 null,而是确认没有其他仍在使用它的所有者。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

释放不用的资源引用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通