游戏客户端架构 / 系统课时
命令为什么要延迟执行
命令为什么要延迟执行
在 ECS 中,击杀敌人后常要销毁实体、移除组件或生成掉落物。若 System 一边遍历查询结果一边改变实体结构,当前遍历可能失效,其他 System 也会看到不一致的集合。本课用命令缓冲区把“决定修改什么”和“实际修改世界”分开,并确定安全提交点。
学习目标
- 区分结构变化命令与状态事件的职责。
- 解释为什么遍历期间不应直接修改实体结构。
- 实现命令入队、同步点提交并验证结果。
结构变化为什么不能立即执行
更新已有 Health.hp 通常只修改组件值;销毁实体、创建实体、增删组件则可能改变 Archetype 或 Chunk 的布局,使实体搬移、查询匹配集变化。在遍历或并行读取期间执行这些操作,可能令迭代器、组件视图或其他 System 的访问假设失效。
例如 DamageSystem 正在遍历所有带 Health 的实体,发现生命值为零就直接移除组件,后续访问可能跳项或引用到失效数据。复制一份实体 ID 列表也不能彻底解决:它只隔离列表遍历,不能保证多 System 看到一致的结构状态。
事件和命令负责不同的事
状态事件描述已经发生的事实,例如 entity.dead 通知音效、战报和 UI 某个实体已死亡;结构命令表达尚未执行的世界操作,例如 DestroyEntity(2) 或 AddComponent(2, LootTag)。事件偏向传递事实,命令必须在受控时机改变实体结构。
二者可以由同一次死亡判定产生,却不能互相替代。只有死亡事件而没有销毁命令会留下实体;让每个事件消费者自行销毁,又容易形成重复操作。若消费者需要死亡前的生命值或位置,应在事件载荷中保存快照,而不是等实体销毁后再读取句柄。
把提交放在安全同步点
正确顺序是:System 查询稳定实体集、将结构操作写入命令缓冲区、等待相关遍历与并行任务结束、在同步点执行 Playback,然后允许后续查询观察新结构。延迟执行不一定意味着等到下一帧,也可以是同一帧中的阶段边界。

并行 System 可使用各线程缓冲再合并;多个命令针对同一实体时,需定义顺序、去重与冲突规则,不能把线程抢先写入当作稳定语义。
用最小世界验证提交前后
下面是可直接运行的 Python 3 示意模型,以字典模拟实体存储,而非某个 ECS 引擎的真实 API。遍历时仅记录死亡事件和销毁意图,最后统一播放命令。
class World:
def __init__(self):
self.entities = {1: 15, 2: 0, 3: 5} # entityId -> hp
self.commands = []
self.events = []
def queue_destroy(self, entity_id):
self.commands.append(("destroy", entity_id))
def playback(self):
for op, entity_id in self.commands:
if op == "destroy":
self.entities.pop(entity_id, None)
self.commands.clear()
world = World()
# 遍历期只记录意图,不直接删除实体。
for entity_id, hp in world.entities.items():
if hp <= 0:
world.events.append(("entity.dead", entity_id, hp))
world.queue_destroy(entity_id)
print("事件:", world.events)
print("提交前:", sorted(world.entities))
world.playback()
print("提交后:", sorted(world.entities))预期输出:
事件: [('entity.dead', 2, 0)]
提交前: [1, 2, 3]
提交后: [1, 3]事件已生成、命令已排队时,实体 2 仍存在;只有执行 playback 后,后续查询才看不到它。真正的 ECS 项目应改用所选框架提供的命令缓冲区和同步屏障。
用边界情况检验提交规则
验收时重点检查:遍历期间匹配集合保持稳定;提交前不发生结构写入;提交后重新查询得到预期实体集。再测试重复死亡通知、同一实体既添加组件又销毁、多个生产者同时写入,避免重复掉落、冲突命令或访问已销毁实体。命令延迟的是结构修改时机,不是业务决定本身。