游戏客户端架构 / 系统课时

Entity 到底保存什么

Entity 到底保存什么

在 ECS 中,Entity 不是装着坐标、生命值和渲染器的大对象,而是用来定位组件数据的身份句柄。本课会区分编号与真实数据,通过创建、销毁和复用编号的示例理解代际校验,并说明组件由谁负责保存和清理。

学习目标

  • 说清 Entity 身份、组件数据和 System 职责的边界。
  • 理解索引与代际编号为什么要一起校验。
  • 用可运行示例验证销毁后旧句柄不能访问新实体。

Entity 表示谁,不负责存什么

ECS 常把 Entity 表示为整数 ID,或包含 Index 与 Generation 的小型值。它回答“是哪一个实体”,通常不直接保存位置、速度或生命值,也不负责执行 Move()、TakeDamage() 这样的游戏行为。

  • Entity:身份句柄,便于各组件记录属于谁。
  • Component:例如 Position、Health,保存一个方面的数据。
  • System:例如 MovementSystem,批量处理满足组件条件的实体。

因此,“玩家实体有 Position”通常意味着组件存储中存在一条以该身份关联的 Position 数据,而不是玩家对象内嵌一个位置字段。不同 ECS 实现可使用稀疏集合、原型块或其他布局;身份语义不依赖某一种存储方案。

句柄怎样关联到组件

典型查询会先校验句柄是否有效,再由组件存储按实体索引或内部映射定位数据。实体获得 Health 组件时,可以加入生命值系统的查询结果;移除后便不再匹配。系统只操作需要的组件,并不要求 Entity 持有指向每个组件的对象引用。

Entity 身份句柄、组件存储与代际复用的关系

只使用裸整数编号容易产生复用误认:编号 7 的敌人销毁后,编号 7 被分配给新敌人,旧的攻击目标引用就可能误伤新对象。因此常为槽位加入 Generation;每次销毁时递增代际,旧句柄即使索引相同也无法通过校验。

用最小注册表验证身份复用

以下代码可放入 .NET 6 或更新版本的控制台项目 Program.cs。示例用 Dictionary 保存位置,是为了直观看到“句柄与数据分离”;它不是高性能组件存储的推荐最终实现。

csharp
using System;
using System.Collections.Generic;

var registry = new EntityRegistry();
var positions = new Dictionary<Entity, Position>();
Entity first = registry.Create();
positions[first] = new Position(3, 5);
Console.WriteLine($"旧实体: {first.Index}/{first.Generation}, 坐标: {positions[first].X},{positions[first].Y}");

// 销毁实体时,调用方还要清理各组件存储。
registry.Destroy(first);
positions.Remove(first);
Entity second = registry.Create();
Console.WriteLine($"新实体: {second.Index}/{second.Generation}");
Console.WriteLine($"旧句柄有效: {registry.IsAlive(first)}");
Console.WriteLine($"新句柄有效: {registry.IsAlive(second)}");
Console.WriteLine($"旧组件仍在: {positions.ContainsKey(first)}");

readonly record struct Entity(int Index, int Generation);
readonly record struct Position(int X, int Y);

sealed class EntityRegistry
{
    private readonly List<int> generations = new();
    private readonly List<bool> alive = new();
    private readonly Stack<int> free = new();

    public Entity Create()
    {
        if (free.Count > 0)
        {
            int reused = free.Pop();
            alive[reused] = true;
            return new Entity(reused, generations[reused]);
        }

        int index = generations.Count;
        generations.Add(0);
        alive.Add(true);
        return new Entity(index, 0);
    }

    public bool IsAlive(Entity entity) =>
        entity.Index >= 0 &&
        entity.Index < generations.Count &&
        alive[entity.Index] &&
        generations[entity.Index] == entity.Generation;

    public void Destroy(Entity entity)
    {
        if (!IsAlive(entity))
            throw new InvalidOperationException("实体句柄已失效");

        // 先使旧句柄失效,再开放槽位复用。
        alive[entity.Index] = false;
        generations[entity.Index]++;
        free.Push(entity.Index);
    }
}

预期输出:

text
旧实体: 0/0, 坐标: 3,5
新实体: 0/1
旧句柄有效: False
新句柄有效: True
旧组件仍在: False

first 与 second 共享索引 0,但代际不同。Destroy() 只管理身份槽位,所以示例明确调用 positions.Remove(first);正式 ECS 应由统一的实体销毁流程清理组件和查询索引,避免遗留脏数据。

哪些标识不能互相替代

有效期和作用域是实体身份的两个边界。上面的句柄仅在同一个注册表中有意义:不同世界可能都存在 (0,1),跨世界引用需额外区分所属 World。句柄也只保证实体存活期间的访问安全,不应该直接当作存档 ID 或网络同步中的永久业务标识。

如果需要跨场景存档、断线重连或网络重建,应另外维护稳定业务 ID 到当前 Entity 的映射。业务身份负责“逻辑上还是同一个角色”,Entity 负责“当前世界中哪一个存活实例”。把这两层区分开,才能在迁移组件、复用槽位和重建世界时避免悬空引用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Entity 到底保存什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通