游戏引擎 / 系统课时

缓存节点与组件引用

缓存节点与组件引用

移动端 UI 更新如果反复搜索子节点、查询组件或重新请求资源,就会在真正的业务逻辑之外增加开销。本课以生命值显示为例,将节点与组件查找集中到初始化阶段,后续点击只修改已缓存的 Label,并处理销毁、重建和资源引用的边界。

学习目标

  • 找出高频路径中的重复节点、组件和资源查询。
  • 在 onLoad 缓存稳定组件,更新时直接使用并验证效果。
  • 判断缓存何时失效,避免持有已销毁对象或无期限保留资源。

找到真正重复的查找

典型坏味道是在每次受击、每帧刷新时运行 getChildByName('HpValue') 再调用 getComponent(Label)。前者要从父节点寻找子节点,后者还要查询节点上的组件;如果界面层级稳定,重复执行通常没有价值。

先用性能工具确认这段代码位于频繁调用的路径,并记录执行次数。只有在初始化时找一次,后续直接持有 Label 引用,才是本例的优化目标。不要把优化理解为预先缓存场景中的全部对象,那会增加维护成本。

让查找只发生在初始化

建立 Panel 节点,下面放 HpRoot,其直接子节点 HpValue 带 Label 组件。脚本在 onLoad 通过 HpRoot 找到 HpValue 并缓存组件;按钮事件调用 takeDamage 时不再查找节点树。

生命值界面中节点查找与组件缓存的结构关系

使用以下 HealthPanel.ts。为方便跟做,按钮点击监听也在脚本中注册;在编辑器中将 HpRoot 节点和按钮的 Button 组件分别拖到 hpRoot、damageButton 属性。

ts
import { _decorator, Button, Component, Label, Node, isValid } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('HealthPanel')
export class HealthPanel extends Component {
  @property({ type: Node }) hpRoot: Node | null = null;
  @property({ type: Button }) damageButton: Button | null = null;

  private hpLabel: Label | null = null;
  private hp = 100;

  protected onLoad(): void {
    // 节点层级固定,查找只做一次。
    const valueNode = this.hpRoot?.getChildByName('HpValue');
    this.hpLabel = valueNode?.getComponent(Label) ?? null;
    if (!this.hpLabel) {
      console.warn('HealthPanel: 未找到 HpValue 上的 Label');
      return;
    }
    this.renderHealth();
  }

  protected onEnable(): void {
    this.damageButton?.node.on(Button.EventType.CLICK, this.takeDamage, this);
  }

  protected onDisable(): void {
    this.damageButton?.node.off(Button.EventType.CLICK, this.takeDamage, this);
  }

  private takeDamage(): void {
    this.hp = Math.max(0, this.hp - 10);
    this.renderHealth();
  }

  private renderHealth(): void {
    // 动态销毁组件后,旧引用不能继续写入。
    if (!this.hpLabel || !isValid(this.hpLabel, true)) return;
    this.hpLabel.string = `HP: ${this.hp}`;
  }

  protected onDestroy(): void {
    this.hpLabel = null;
  }
}

预期结果:运行后 HpValue 显示 HP: 100,点击一次按钮变为 HP: 90,再点击变为 HP: 80;重复点击不会让生命值低于 0。getChildByName 和 getComponent 在每次实例初始化时各执行一次,而非每次受击都执行。

缓存的范围由生命周期决定

onLoad 适合缓存当前界面实例内长期稳定的组件;对象池重新绑定不同目标或运行时替换 HpValue 时,必须重新查找或显式更新缓存。isValid(obj, true) 可以防止使用已开始销毁的对象,但不会自动把旧引用指向新节点;因此更换对象后仍需重新绑定。

对于固定的编辑器引用,直接使用 @property({ type: Label }) 拖入目标组件通常比按名字查找更稳健。名称查找依赖节点结构,重命名或换层级后会返回空值;示例保留查找是为了演示何处缓存,而非推荐所有界面都用名称定位。

资源缓存与性能验收

SpriteFrame、Prefab 等资源也不应在高频更新函数中反复发起 resources.load。可以在界面进入时加载一次并复用获得的资源引用;Creator 的 Asset Manager 本身会缓存已加载资源,但反复调用加载接口仍有管理和回调成本。跨场景长期持有资源时,应按实际所有权配对使用 addRef、decRef,避免误释放或内存常驻。

验证时,在相同真机和操作量下对比查找调用次数、脚本耗时及内存曲线。缓存降低的是重复查询,并不会消除文本排版或渲染的成本;如果性能瓶颈不在查找,下一步应继续检查 UI 刷新频率,而不是盲目增加缓存。

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

目录与阅读设置

阅读设置

17

记录一个想法

缓存节点与组件引用

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

登录哪都通