# Id 机制分析

## 作用定位

`Engine/Common/Id.h` 是整个运行时句柄系统的基础。  
核心目标是用一个 `u32` 同时表达：

- 资源在数组中的索引；
- 该索引的生命周期代数（generation）。

## 位布局

- `id_type = u32`
- 高位：generation（`generation_bits = 8`）
- 低位：index（`index_bit = 24`）

对应关键常量与工具：

- `index_mask`：提取低位索引
- `generation_mask`：提取高位代数
- `invalid_id`：无效句柄哨兵值

## 核心函数语义

- `is_valid(id)`：判断是否不是无效值
- `index(id)`：提取索引位
- `generation(id)`：提取代数位
- `new_generation(id)`：索引不变，代数递增

## 运行时价值

它主要解决“删除后旧句柄仍被外部持有”的问题：

1. 对象删除后，槽位可复用；
2. 复用时代数 +1；
3. 旧句柄的 generation 与当前 generation 不一致；
4. 存活校验失败，避免误访问新对象。

## 强类型策略

`DEFINE_TYPED_ID(name)`：

- Debug：生成包装类型，增强类型隔离；
- Release：退化为 `id::id_type`，零额外开销。

这是“开发期安全 + 发布期性能”的组合设计。