组件生命周期、事件与异步清理
一个组件可能被创建、启用、停用、再次启用、加入对象池和最终销毁。把这些变化想成服务进程的启动关闭还不够:游戏对象可能在短时间里反复经历多轮状态,异步回调又可能跨过这些边界。
分清一次初始化与每次启用
Cocos的onLoad用于初始化,onEnable/onDisable与启用状态相关,start在首次更新前执行,update按帧执行,onDestroy用于最终清理。不同组件的业务依赖不能只靠你猜测回调顺序;明确的初始化接口通常更容易推理。
onEnable(){
input.on(Input.EventType.KEY_DOWN,this.onKeyDown,this);
}
onDisable(){
input.off(Input.EventType.KEY_DOWN,this.onKeyDown,this);
this.clearHeldInputs();
}
onDestroy(){
this.cancelOutstandingWork();
}
导入与类定义按实际项目补齐。这里重要的是订阅和取消使用同一个事件、回调引用与target。用新的箭头函数执行off,通常不能移除当初注册的函数。
异步初始化不会自动串行
把onLoad写成async,不能据此假设引擎会等待它完成才调用其他回调。资源加载期间要有明确loading状态,或先准备好依赖再激活节点。不要让update一边访问尚未加载的资源,一边用大量空值判断掩盖初始化顺序。
private version=0;
private activeRequest=false;
async loadVisual(){
const version=++this.version;
this.activeRequest=true;
try{
const asset=await this.loader();
if(!this.activeRequest||version!==this.version)return;
this.applyVisual(asset);
}finally{
if(version===this.version)this.activeRequest=false;
}
}
onDisable(){this.activeRequest=false;this.version++;}
这个例子表达请求失效策略,资源所有权仍由项目的加载封装负责。加载失败要进入可解释的错误或重试状态,不能永远停在loading。若同一节点停用后重新启用,要确认旧请求不会覆盖新请求。
计时器与时间源也有生命周期
引擎调度、Tween、动画、JavaScript定时器和模拟时间各有行为。不要假设暂停一个系统会冻结其他所有系统。先决定功能使用哪种时间:局内攻击通常跟随模拟时间;真实活动截止时间需要可信墙钟;UI加载超时可能继续使用真实时间。
定时回调退出后仍写入旧角色,是常见“偶发复活”来源。状态退出时取消工作,或让回调携带状态版本。不要每帧把状态强制改回去;那会让真正的非法写入继续存在。
对象池不是销毁
回收到池中不一定调用onDestroy,因此伤害去重、临时目标、动画进度、输入和计时器必须在明确的回收/再利用流程重置。节点active改变的生命周期应与项目池化方式一起验证。资源引用若长期由池保留,也会影响内存释放。
你可以为每种可复用对象列一张重置表:初始生命、位置、朝向、目标、速度、冷却、事件订阅、特效与资源引用。用“第一次生成→受伤→回收→再次生成”的测试,比只看构造函数更能证明复用正确。
AI任务与验收
请检查角色组件在创建、启用、停用、池回收、复用、销毁后的行为。
列出所有订阅、计时器、Tween、异步请求与资源持有者。
构造快速启停、加载中切场景、回收后旧回调返回的复现。
只在实际生命周期边界清理,并证明复用后没有重复输入与旧状态。
验收时记录监听调用次数、活跃对象和资源数。重复启停十次后,一次按键仍只触发一次动作;旧异步结果不覆盖新对象;暂停与后台行为符合规格;销毁后无访问异常。
来源与版本
核查日期2026-11-17,Creator3.8.8。简化代码表达业务策略,需要按实际组件与资源封装整合。