游戏客户端架构 / 系统课时
跑通一个最小 ECS 世界
跑通一个最小 ECS 世界
本课用 Python 标准库搭建一个能更新的 ECS 世界:玩家拥有位置和速度,石块只有位置。运行一次 MovementSystem 后,你将看到玩家移动、石块保持不动,并理解系统如何根据组件组合选择实体。
学习目标
- 用实体 ID、组件存储和 System 组成最小 ECS。
- 理解系统怎样筛选实体并按时间步长更新状态。
- 运行代码,验证拥有不同组件的实体行为不同。
把身份、状态和行为拆开
Entity 只负责标识,例如 101 是玩家、102 是石块;它不必有继承层次或 update() 方法。Position(x, y) 与 Velocity(vx, vy) 是组件,只存数值,不负责计算。
World 用两张以实体 ID 为键的表保存组件。MovementSystem 从速度表读取候选 ID,再查找对应位置:同时拥有两种组件的实体才进入移动计算。石块没有速度组件,因此不会因为被遍历到就移动。

编写并执行更新循环
使用 Python 3.9 或更高版本,将以下代码保存为 minimal_ecs.py,执行 python minimal_ecs.py。示例故意使用字典呈现组件匹配机制,不把它伪装成已优化的连续内存 ECS。
from dataclasses import dataclass
@dataclass
class Position:
x: float
y: float
@dataclass
class Velocity:
vx: float
vy: float
class World:
def __init__(self) -> None:
self.positions: dict[int, Position] = {}
self.velocities: dict[int, Velocity] = {}
def movement_system(world: World, dt: float) -> None:
# 只更新同时拥有位置和速度组件的实体
for entity_id, velocity in world.velocities.items():
position = world.positions.get(entity_id)
if position is None:
continue
position.x += velocity.vx * dt
position.y += velocity.vy * dt
def show_positions(world: World) -> None:
for entity_id in sorted(world.positions):
p = world.positions[entity_id]
print(f'Entity {entity_id}: ({p.x:.1f}, {p.y:.1f})')
world = World()
# 实体只是 ID,数据按组件类型分别登记
world.positions[101] = Position(1.0, 2.0)
world.velocities[101] = Velocity(4.0, 0.0)
world.positions[102] = Position(10.0, 3.0)
print('更新前')
show_positions(world)
movement_system(world, 0.5)
print('更新后')
show_positions(world)预期输出:
更新前
Entity 101: (1.0, 2.0)
Entity 102: (10.0, 3.0)
更新后
Entity 101: (3.0, 2.0)
Entity 102: (10.0, 3.0)逐步核对筛选和写回
系统遍历速度表,因此拿到实体 101;再根据同一 ID 找到其 Position。在半秒内,横向位移为 4.0 × 0.5 = 2.0,于是 x 从 1.0 变为 3.0,纵向速度为 0,因此 y 不变。
实体 102 虽然有 Position,却不在速度表中,因此不进入系统循环。反过来,如果速度表存在某个 ID 但位置表没有,代码也会通过 continue 跳过,避免访问不存在的组件。这是组件匹配,而不是在对象类型上判断“玩家还是石块”。
这里的 dt 表示本次更新经过的时间,单位为秒。位置变化量等于速度乘以时间,因此系统不需要知道实体是玩家、敌人还是道具,只需要拿到对应组件数据。
改动一次验证组合能力
将 world.velocities[102] = Velocity(0.0, -2.0) 加到调用 movement_system 之前并重新运行,石块的位置应从 (10.0, 3.0) 变为 (10.0, 2.0),无需修改 System。再尝试连续调用两次、每次 dt=0.5:玩家的 x 应从 1.0 依次变为 3.0、5.0。
还可以删除玩家的速度组件并重新执行程序。此时两个实体都不会移动,但位置数据依然存在。这说明实体的能力由组件组合决定,组件可以独立增加或移除,而 System 不必维护一套实体类型分支。
这个例子解决的是 ECS 的职责分离和更新闭环。真实游戏还要处理实体销毁、组件增删、系统执行顺序以及连续内存布局,但它们不改变“按组件筛选数据,再由 System 执行行为”的基本规则。