Function initialize

packages/core/src/ECS/Systems/EntitySystem.ts:436–460

* 系统初始化（框架调用） * * 在系统创建时调用。框架内部使用，用户不应直接调用。

()

     * 在系统创建时调用。框架内部使用，用户不应直接调用。
     */
    public initialize(): void {
        // 防止重复初始化 | Prevent re-initialization
        if (this._initialized) {
            return;
        }

        this._initialized = true;

        // 框架内部初始化：触发一次实体查询，以便正确跟踪现有实体
        // Framework initialization: query entities once to track existing entities
        if (this.scene) {
            // 清理缓存确保初始化时重新查询 | Clear cache to ensure fresh query
            this._entityCache.invalidate();
            const entities = this.queryEntities();

            // 初始化时对已存在的匹配实体触发 onAdded
            // Trigger onAdded for existing matching entities during initialization
            for (const entity of entities) {
                this.onAdded(entity);
            }
        }

        // 调用用户可重写的初始化方法 | Call user-overridable initialization method
        this.onInitialize();
    }

    /**
     * 系统初始化回调