游戏客户端架构 / 系统课时
组件生命周期
组件生命周期
组件生命周期解决的是“某段逻辑应当在什么时候执行”的问题。通过统一创建、启用、更新、禁用和销毁回调,组件可以安全地申请资源、参与帧循环并在退出场景前完成清理,避免重复初始化、失效对象仍被更新以及资源泄漏。
学习目标
- 说明五类生命周期回调的触发时机与执行顺序
- 实现一个具备状态保护的基础组件
- 识别重复启用、销毁后更新等常见错误
生命周期状态与顺序
一个组件通常从“已创建”开始,启用后才进入帧更新;被禁用时停止更新,但对象仍然存在;销毁后则不能再次启用或更新。引擎必须把这些状态变化集中管理,而不是让业务代码随意调用回调。

推荐顺序如下:构造组件后调用一次 onCreate;状态由禁用变为启用时调用 onEnable;仅启用组件参与 onUpdate;从启用变为禁用时调用 onDisable;最终释放前调用一次 onDestroy。其中 onCreate 和 onDestroy 都应保证只执行一次。
实现带状态保护的组件
下面的完整示例用状态枚举约束回调。公开方法负责检查状态,派生组件只实现受保护的生命周期函数,因此业务代码无法绕过规则直接更新已销毁组件。
#include <iostream>
#include <stdexcept>
#include <string>
#include <utility>
class Component {
public:
enum class State { Constructed, Created, Enabled, Disabled, Destroyed };
void initialize() {
ensureAlive();
if (state_ != State::Constructed) {
return;
}
state_ = State::Created;
onCreate();
}
void enable() {
ensureAlive();
if (state_ == State::Constructed) {
initialize();
}
if (state_ == State::Enabled) {
return;
}
state_ = State::Enabled;
onEnable();
}
void update(float deltaTime) {
ensureAlive();
if (state_ == State::Enabled) {
onUpdate(deltaTime);
}
}
void disable() {
ensureAlive();
if (state_ != State::Enabled) {
return;
}
state_ = State::Disabled;
onDisable();
}
void destroy() {
if (state_ == State::Destroyed) {
return;
}
if (state_ == State::Constructed) {
initialize();
}
if (state_ == State::Enabled) {
state_ = State::Disabled;
onDisable();
}
state_ = State::Destroyed;
onDestroy();
}
virtual ~Component() = default;
protected:
virtual void onCreate() {}
virtual void onEnable() {}
virtual void onUpdate(float) {}
virtual void onDisable() {}
virtual void onDestroy() {}
private:
void ensureAlive() const {
if (state_ == State::Destroyed) {
throw std::logic_error("component is destroyed");
}
}
State state_ = State::Constructed;
};
class Spinner final : public Component {
protected:
void onCreate() override {
std::cout << "create\n";
}
void onEnable() override {
std::cout << "enable\n";
}
void onUpdate(float deltaTime) override {
std::cout << "update " << deltaTime << "\n";
}
void onDisable() override {
std::cout << "disable\n";
}
void onDestroy() override {
std::cout << "destroy\n";
}
};
int main() {
Spinner spinner;
spinner.initialize();
spinner.enable();
spinner.update(0.016f);
spinner.disable();
spinner.update(0.016f);
spinner.destroy();
}预期输出:
create
enable
update 0.016
disable
destroy第二次 update 没有输出,因为组件已经禁用。若在 destroy 后继续调用 enable 或 update,示例会抛出异常,从而尽早暴露错误调用。
回调中应放什么
onCreate 适合建立组件内部数据,但不要依赖其他对象已经完成初始化;onEnable 适合订阅事件、注册更新或启动临时效果;onUpdate 只处理本帧逻辑;onDisable 应撤销启用阶段的注册;onDestroy 负责最终释放资源和断开外部引用。
Tips:成对操作要放在成对回调中。例如在
onEnable订阅事件,就在onDisable取消订阅,而不是等到销毁时才处理。
常见边界
禁用不等于销毁。被禁用的组件仍可保留配置和运行进度,之后重新启用;已销毁组件则应视为永久失效。销毁启用中的组件时,通常先触发 onDisable,再触发 onDestroy,以保证事件订阅和更新注册先被撤销。
回调还应避免重入。例如 onDisable 内不要再次调用 disable,onDestroy 内不要把自己重新加入更新列表。引擎侧使用状态机和幂等检查,可以阻止大多数重复调用。
本课总结
- 生命周期状态决定组件能否参与更新,回调不能被业务代码随意跳过
onCreate、onDestroy只执行一次,启用与禁用可以多次成对发生- 销毁启用中的组件时,应先禁用再销毁,并禁止后续更新
下一课预告
下一课将把组件放入场景对象体系,完成对象创建、查找、遍历以及安全的延迟删除。