游戏客户端架构 / 系统课时
一个组件只负责什么
一个组件只负责什么
角色受伤后需要扣血、播放受击音效、更新血条,甚至触发死亡动画。如果把这些行为都放进一个生命值组件,它会随着界面和表现需求不断膨胀。本课用可运行的生命值示例,明确组件应该接收什么、保存什么、输出什么,以及哪些职责必须留给外部系统。
学习目标
- 用状态所有权和变化原因判断组件是否职责单一。
- 为组件写出明确的输入、内部状态与输出契约。
- 通过独立运行和变更测试验证组件不依赖界面、声音等外部功能。
从状态所有权界定职责
以 HealthComponent 为例,它负责维护当前生命值,保证数值处于 0 到最大生命值之间,并在数值变化时发出通知。扣血前的命中判定、护甲计算属于战斗规则;血条怎么画、死亡音效怎么播属于表现系统。
判断职责是否过大,不是数方法个数,而是问:这些方法是否因为同一种业务规则变化而改变? 调整生命值上下限可能修改 HealthComponent;更换 HUD 布局或音效资源则不应改它。
写清输入、状态和输出契约
先给组件写一份可以验证的契约,再决定具体引擎实现:
| 边界 | 内容 | 规则 |
|---|---|---|
| 输入 | applyDamage(amount) |
接收已结算的非负伤害 |
| 状态 | maxHp、currentHp |
不低于 0,且不高于 maxHp |
| 输出 | HealthChanged |
仅在数值实际变化时发出变化前后值 |
| 外部消费者 | HUD、音频、动画 | 订阅或接收事件,不由组件直接调用 |

这张图的关键不是事件机制本身,而是依赖方向:组件可以通知“生命值已经变化”,却不应知道通知最终驱动血条、震屏还是声音。即使不用事件总线,也可通过注入的回调保持这一边界。
用最小代码验证组件行为
下面示例可保存为 health.js,在 Node.js 中运行。为了独立测试,组件不引用任何游戏引擎 API;实际项目可把同样的状态规则放入引擎组件,再用适配层连接事件系统。
class HealthComponent {
constructor(maxHp, onChanged) {
if (!Number.isFinite(maxHp) || maxHp <= 0) {
throw new Error("maxHp 必须为正数");
}
this.maxHp = maxHp;
this.currentHp = maxHp;
// 外部注入通知出口,生命值组件不认识 HUD 或音频对象。
this.onChanged = onChanged;
}
applyDamage(amount) {
// 命中和护甲已在组件之外结算。
if (!Number.isFinite(amount) || amount < 0) {
throw new Error("伤害必须是非负有限数");
}
const previousHp = this.currentHp;
this.currentHp = Math.max(0, previousHp - amount);
// 状态没变就不重复通知消费者。
if (previousHp !== this.currentHp) {
this.onChanged({ previousHp, currentHp: this.currentHp });
}
}
}
const health = new HealthComponent(100, ({ previousHp, currentHp }) => {
console.log(`生命值:${previousHp} -> ${currentHp}`);
});
health.applyDamage(30);
health.applyDamage(500);
health.applyDamage(10);预期输出:
生命值:100 -> 70
生命值:70 -> 0第一次扣血正常下降;第二次超过剩余生命值也只会归零;第三次在零生命值时没有变化,因此不会产生第三条通知。这分别验证了范围约束、边界处理和通知条件。回调这里只负责打印,换成事件发布器也不需要修改扣血规则。
处理新需求时决定放在哪里
若加入护甲减伤,应先由战斗系统计算最终伤害,再传给 applyDamage,避免生命值组件依赖武器、护甲和攻击者。如果加入中毒持续掉血,可由状态效果组件定时提交伤害;生命值组件仍只处理数值变化。死亡是否触发一次,则需定义清楚:生命值组件可以输出首次降到零的事实,但播放死亡动画、发放奖励和销毁对象应由各自负责的模块处理。
验收时尝试替换 HUD、关闭所有音效、增加一个新的受击特效。如果这三件事均无需修改 HealthComponent,而扣血、封顶和事件测试仍通过,说明组件边界具备实际可维护性;若一改界面就要改扣血代码,应将表现逻辑移出组件。