游戏引擎 / 系统课时
用节点和组件组织游戏对象
用节点和组件组织游戏对象
把角色的显示、移动和碰撞都理解成一个节点的固有能力,容易导致脚本职责混乱。Cocos 的节点表达归属与变换,组件提供具体行为;本节创建一个子节点并给它添加显示相关组件,观察二者的边界。
学习目标
- 区分节点层级与组件依赖
- 创建子节点并访问指定组件
- 判断停用和销毁对对象生命周期的影响
层级表示归属,组件表示能力
节点有名称、父子关系、位置、旋转和缩放。Sprite 负责精灵渲染,UITransform 提供 2D UI 的尺寸与锚点,脚本组件负责游戏行为。多个组件可以挂在同一个节点上;它们不会因为排列在属性检查器中就变成父子节点。

父节点移动会影响子节点的世界变换,适合让武器、特效跟随角色。组件之间的调用则要通过明确引用或 getComponent,不能因为两个组件挂在同一节点上就推断它们的业务执行顺序。
创建并检查组成
在 Creator 3.8.8 中保存为 CompositionProbe.ts,挂到场景中的空节点 Runner。这个示例验证对象组成,不要求先准备图片。
import { _decorator, Component, Node, Sprite, UITransform } from 'cc';
const { ccclass } = _decorator;
@ccclass('CompositionProbe')
export class CompositionProbe extends Component {
start(): void {
const avatar = new Node('Avatar');
this.node.addChild(avatar); // 明确新节点归谁管理
avatar.addComponent(UITransform).setContentSize(64, 64);
avatar.addComponent(Sprite); // 没有 SpriteFrame 时不显示图片
const hasSize = avatar.getComponent(UITransform) !== null;
const hasSprite = avatar.getComponent(Sprite) !== null;
console.log(avatar.name + ':' + hasSize + ':' + hasSprite);
}
}预期结果:运行层级里 Runner 下出现 Avatar,日志输出 Avatar:true:true。此时看不到角色图片是正常的:Sprite 组件存在与拥有可渲染的 SpriteFrame 是不同条件。
让引用和生命周期一致
若组件是功能必需项,创建或初始化时立即检查;不要在每帧不断查找并假定返回值不为空。getComponent 返回 null 时,应报清楚缺失的能力或停止当前行为,不能只用非空断言推迟错误。
将节点 active 设为 false 会影响其在层级中的激活状态,适合暂时隐藏或停用;destroy() 表示安排销毁,不能把它当作可逆的暂停。拥有运行时创建对象的系统应负责退出时清理,避免对象已经离开场景但监听或计时逻辑仍持有引用。
拆分节点时以共同变换和生命周期为依据。只有显示细节需要偏移时,可以把显示放到角色的子节点;碰撞与移动应围绕明确的主体节点协作,避免多个脚本同时改同一位置。