游戏引擎 / 系统课时
缓存节点与组件引用
缓存节点与组件引用
移动端 UI 更新如果反复搜索子节点、查询组件或重新请求资源,就会在真正的业务逻辑之外增加开销。本课以生命值显示为例,将节点与组件查找集中到初始化阶段,后续点击只修改已缓存的 Label,并处理销毁、重建和资源引用的边界。
学习目标
- 找出高频路径中的重复节点、组件和资源查询。
- 在
onLoad缓存稳定组件,更新时直接使用并验证效果。 - 判断缓存何时失效,避免持有已销毁对象或无期限保留资源。
找到真正重复的查找
典型坏味道是在每次受击、每帧刷新时运行 getChildByName('HpValue') 再调用 getComponent(Label)。前者要从父节点寻找子节点,后者还要查询节点上的组件;如果界面层级稳定,重复执行通常没有价值。
先用性能工具确认这段代码位于频繁调用的路径,并记录执行次数。只有在初始化时找一次,后续直接持有 Label 引用,才是本例的优化目标。不要把优化理解为预先缓存场景中的全部对象,那会增加维护成本。
让查找只发生在初始化
建立 Panel 节点,下面放 HpRoot,其直接子节点 HpValue 带 Label 组件。脚本在 onLoad 通过 HpRoot 找到 HpValue 并缓存组件;按钮事件调用 takeDamage 时不再查找节点树。

使用以下 HealthPanel.ts。为方便跟做,按钮点击监听也在脚本中注册;在编辑器中将 HpRoot 节点和按钮的 Button 组件分别拖到 hpRoot、damageButton 属性。
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 刷新频率,而不是盲目增加缓存。