游戏客户端架构 / 系统课时
一个 System 怎样选中实体
一个 System 怎样选中实体
本课把“更新会移动的实体”落实为一个明确的查询:只选出同时拥有 Position 与 Velocity 的实体,再逐个更新位置。你将通过一份可运行的最小 ECS 数据,理解 System 如何确定处理范围,并验证哪些实体会被选中。
学习目标
- 理解 System 如何根据组件组合筛选实体,而不是根据实体名称或类型判断。
- 能够编写最小组件查询,并用查询结果驱动位置更新。
- 能够区分查询匹配、组件读取和状态写回三个环节。
用组件需求定义查询
在 ECS 中,Entity 主要提供身份,Component 保存数据,System 负责处理符合条件的实体。一个 MovementSystem 想要更新位置,需要读取 Velocity,并写回 Position。因此,它最基本的查询条件就是实体必须同时拥有这两个组件。
假设世界中有四个实体:
| Entity | 拥有的组件 | 是否命中 |
|---|---|---|
| 101 玩家 | Position、Velocity、Health | 是 |
| 102 石块 | Position | 否 |
| 103 子弹 | Position、Velocity | 是 |
| 104 速度记录对象 | Velocity | 否 |
Entity 101 虽然额外拥有 Health,但这不会影响匹配。Entity 102 缺少 Velocity,Entity 104 缺少 Position,因此都不能进入 MovementSystem 的更新集合。
这里的关键规则是:查询要求的所有组件都必须存在,但实体可以拥有更多未被查询要求的组件。

这种机制让系统和实体的具体身份解耦。只要新增的实体拥有 Position 与 Velocity,它就能自动进入运动查询;即使实体从玩家变成投射物,MovementSystem 也不需要针对名称增加特殊分支。
让查询结果驱动位置更新
下面使用原生 Python 模拟一个最小 ECS 世界。为了突出查询语义,示例用字典表示实体及其组件,而不是实现完整的 Archetype 或 Chunk 存储。这是教学用的简化实现,不依赖特定 ECS 框架。
world = {
101: {
"Position": {"x": 1.0},
"Velocity": {"x": 2.0},
"Health": {"hp": 100},
},
102: {"Position": {"x": 8.0}},
103: {
"Position": {"x": 0.0},
"Velocity": {"x": -4.0},
},
104: {"Velocity": {"x": 1.0}},
}
def query(world, required):
# 只有拥有全部必需组件的实体才会命中。
return [
eid
for eid, components in world.items()
if required.issubset(components)
]
def movement_system(world, dt):
matched = query(world, {"Position", "Velocity"})
# 查询只确定处理对象,位置更新由 System 完成。
for eid in matched:
components = world[eid]
position = components["Position"]
velocity = components["Velocity"]
position["x"] += velocity["x"] * dt
return matched
matched = movement_system(world, 0.5)
print("命中:", matched)
for eid in matched:
print(f"{eid}: x={world[eid]['Position']['x']:.1f}")预期输出:
命中: [101, 103]
101: x=2.0
103: x=-2.0Entity 101 的位置从 1.0 更新为 2.0,Entity 103 从 0.0 更新为 -2.0。其余实体没有进入循环,因此不会执行位置计算。
这个示例的 dt=0.5 表示一次更新使用的时间步长。实际游戏一般由固定更新循环或调度器提供时间参数,而不是直接把 0.5 写死在运动逻辑中。
本例按照 Python 字典的插入顺序输出实体 ID,但真实 ECS 查询通常不应依赖实体的遍历顺序。如果处理逻辑需要稳定顺序,应该显式排序或定义独立的顺序规则。
查询、读取和写回不是同一件事
虽然这三个环节经常连续执行,但它们承担不同职责。
查询阶段根据组件是否存在确定候选实体。例如 Query(Position, Velocity) 表达的是组件组合要求,并不关心 Position 中的 x 值,也不会主动计算移动。
读取阶段取得命中实体的组件数据。由于查询已经保证 Position 与 Velocity 同时存在,System 可以在这些实体上安全地读取所需字段,但仍需要保证组件数据本身符合预期格式。
写回阶段执行实际业务计算,把新位置存回 Position。如果把业务计算混入查询筛选逻辑,就容易让过滤条件产生副作用,增加缓存、并行调度和调试的难度。
本例每次查询都扫描所有实体,因此对于 E 个实体,筛选成本随实体数量线性增长。实际 ECS 通常利用组件索引、Sparse Set、Archetype 或 Chunk 预先缩小候选范围,避免每个 System 都完整扫描世界。
组件变化如何影响命中结果
当实体新增或移除组件时,查询结果也应该随之变化。例如给 Entity 102 增加 Velocity,它就满足运动查询;从 Entity 103 移除 Velocity,它就不应继续参与更新。
这类增删组件的操作通常属于结构变化。在采用 Archetype 或 Chunk 的 ECS 中,结构变化可能引起实体迁移、存储重排或查询视图失效,因此不宜在遍历命中集合时随意修改组件组合。更稳妥的做法是在允许的同步点集中应用结构修改。
可以用以下两项检查验证自己的理解:
- 把 Entity 103 的 Velocity 移除,再执行查询,预期只命中 Entity 101。
- 给 Entity 102 增加 Velocity,再执行查询,预期命中 Entity 101、102 和 103,前提是保留 Entity 103 原有组件。
如果实体明明拥有全部必需组件却没有命中,应优先检查查询条件、组件注册状态及结构变更是否已经生效,而不是先修改 System 的运算公式。
System 选择实体的本质,是根据当前组件组合定义数据处理集合。把组件条件设计准确,后续才能可靠地批量迭代、缓存查询结果,并在适当的执行阶段安全更新组件。