游戏引擎 / 系统课时
分清节点和组件各自负责什么
分清节点和组件各自负责什么
在 Cocos Creator 中,一个看得见的游戏对象通常不是由单一类完成所有工作,而是通过节点与多个组件组合实现。本课以一个会自动消失的金币为例,拆分对象的位置、图片显示和行为逻辑,理解节点与组件的职责边界,并建立可以继续扩展的对象结构。
学习目标
- 区分 Node 与 Component 的核心职责。
- 将图片显示、空间变换和行为逻辑组织到同一游戏对象中。
- 理解节点激活状态与组件启用状态的区别。
从金币对象理解节点和组件
假设需要在游戏场景中放置一枚金币。金币要有位置、能够显示图片,还需要根据游戏规则改变状态。
这些工作不应该全部由一个对象脚本从底层实现。Cocos Creator 采用组件化结构,将对象身份与空间层级交给节点,将渲染和业务行为交给相应组件。
| 对象部分 | 主要职责 | 金币示例 |
|---|---|---|
| Node | 保存名称、层级、激活状态和空间变换 | Coin 节点,决定金币放在哪里 |
| UITransform | 管理二维 UI 内容尺寸与锚点 | 决定金币图片的内容区域和锚点 |
| Sprite | 渲染二维图片 | 显示金币的 SpriteFrame |
| 自定义 Component | 执行业务逻辑 | 改变金币颜色,并在指定时间隐藏金币 |
这里最重要的区别是:节点决定对象在场景中的组织方式,组件决定对象拥有哪些功能。
节点不需要自己实现图片绘制;Sprite 也不负责决定金币何时应该消失。自定义脚本负责业务规则,并通过节点和其他组件已有的接口完成操作。
一个节点可以拥有多个不同功能的组件,这些组件共同作用于同一个游戏对象。

这种组合关系不仅适用于金币,也适用于角色、敌人、按钮和其他游戏对象。例如,一个角色节点可以同时拥有渲染组件、动画组件、碰撞组件和控制脚本,而不必创建一个承担全部职责的庞大类。
在场景里组装金币对象
先构建一个最小可运行的二维金币对象,重点观察节点和组件分别存在于什么位置。
- 在 Cocos Creator 3.8 中打开一个包含 Canvas 的二维场景。
- 在 Canvas 下创建一个子节点,命名为
Coin,并确保它使用 UI_2D 层。 - 为
Coin添加 Sprite 组件,给 Sprite Frame 指定一张有效的金币图片。 - 检查节点上的 UITransform,确认图片的内容尺寸和锚点符合预期。
- 在属性检查器中修改
Coin的 Position,把金币放在画面中的可见位置。 - 保存场景,确认预览时能够看到金币图片。
此时可以观察到,Coin 是层级管理器中的一个节点,而 Sprite、UITransform 都作为组件出现在这个节点的属性检查器中。
删除 Sprite 组件后,节点仍然存在,但失去了该组件提供的图片渲染功能。相反,保留 Sprite 并修改节点 Position,则会改变图片的显示位置。这说明空间组织和渲染能力由不同部分负责。
用自定义组件控制金币行为
接下来让金币在场景启动后改变颜色,并在大约两秒后自动隐藏。这能同时验证组件读取、业务脚本执行和节点激活状态切换。
创建 CoinLife.ts,写入以下完整脚本:
import { _decorator, Component, Sprite, Color } from 'cc';
const { ccclass } = _decorator;
@ccclass('CoinLife')
export class CoinLife extends Component {
start() {
const sprite = this.getComponent(Sprite);
if (!sprite) {
console.warn('Coin 缺少 Sprite 组件');
return;
}
// 显示样式交给 Sprite,行为时机交给脚本
sprite.color = new Color(255, 210, 60, 255);
console.log(`节点=${this.node.name},Sprite=已找到`);
// 停留两秒后关闭整个金币节点
this.scheduleOnce(() => {
this.node.active = false;
console.log(`${this.node.name} 已隐藏`);
}, 2);
}
}编译完成后,将 CoinLife 作为脚本组件添加到 Coin 节点,并启动场景预览。
预期输出:
节点=Coin,Sprite=已找到
Coin 已隐藏预览开始后,金币会显示为设置的颜色;经过约两秒,金币从画面消失。第二行日志在定时回调执行后出现,实际触发时刻可能随游戏调度略有变化。
这段代码体现了三个不同层面的协作:
this.node获取当前脚本所在的 Node,用于控制整个金币对象。this.getComponent(Sprite)从同一节点获取 Sprite 组件,用于修改图片颜色。this.scheduleOnce()是 Component 提供的调度接口,用于安排一次延迟执行。
如果遗漏 Sprite 组件,脚本会输出缺少组件的警告并提前返回,不会继续执行后续逻辑。这样可以避免直接访问不存在的组件导致运行错误。
区分节点激活与组件启用
节点和组件都有控制运行状态的能力,但影响范围不同。
| 操作 | 影响范围 | 适合场景 |
|---|---|---|
node.active = false |
关闭节点,使它及其子层级失去激活状态 | 整体隐藏金币、暂时关闭对象 |
sprite.enabled = false |
关闭该 Sprite 组件的渲染功能 | 只隐藏图片,保留其他组件运行 |
coinLife.enabled = false |
禁用指定业务脚本组件 | 暂停该组件的生命周期更新与调度行为 |
节点的激活状态和组件的启用状态会共同影响组件是否有效。如果父节点处于未激活状态,即使子节点自身的 Active 为 true,子节点也不会在场景中处于有效激活状态。
另外,active = false 并不等于销毁节点。被关闭的节点仍然存在于场景对象结构中,可以在适当时候重新激活。真正销毁对象需要使用节点的 destroy() 接口,两者应根据游戏需求选择。
判断什么时候该创建新节点
当一个游戏对象需要独立的位置、旋转、缩放、层级或整体激活状态时,通常适合创建独立节点。例如角色手中的武器需要单独旋转,就可以让武器成为角色的子节点。
如果新增的能力只需要依附于现有对象,例如给金币增加一个自动旋转行为,通常先考虑添加脚本组件,而不是额外创建一个没有实际空间职责的节点。
可以做一个简单验证:保持 Coin 节点不变,分别禁用 Sprite 和 CoinLife,观察图片显示与脚本执行的差异。再将 Coin 的 Active 关闭,确认整枚金币及其组件都不再按正常激活状态工作。
在后续开发中,可以继续为金币添加碰撞检测或收集逻辑组件,但节点仍然负责它在场景中的位置与组织关系。保持节点结构清楚、组件职责单一,能够让同一种行为更容易复用到不同游戏对象上。