Method checkOut

packages/core/src/ECS/Utils/IdentifierPool.ts:106–136

* 获取一个可用的ID * * 返回一个32位ID，高16位为世代版本，低16位为索引。 * * @returns 新分配的实体ID * @throws {Error} 当达到索引限制时抛出错误

()

     * @throws {Error} 当达到索引限制时抛出错误
     */
    public checkOut(): number {
        // 处理延迟回收队列
        this._processDelayedRecycle();

        let index: number;

        if (this._freeIndices.length > 0) {
            // 重用回收的索引
            index = this._freeIndices.pop()!;
        } else {
            // 分配新索引
            if (this._nextAvailableIndex > IdentifierPool.MAX_INDEX) {
                throw new Error(
                    `实体索引已达到框架设计限制 (${IdentifierPool.MAX_INDEX})。` +
                    '这意味着您已经分配了超过65535个不同的实体索引。' +
                    '这是16位索引设计的限制，考虑优化实体回收策略或升级到64位ID设计。'
                );
            }

            index = this._nextAvailableIndex++;

            // 按需扩展世代存储
            this._ensureGenerationCapacity(index);
        }

        const generation = this._generations.get(index) || 1;
        this._stats.totalAllocated++;
        this._stats.currentActive++;

        return this._packId(index, generation);
    }

    /**
     * 回收一个ID