Function matchesEntity

packages/core/src/ECS/Systems/EntitySystem.ts:965–1026

* 检查实体是否匹配当前系统的查询条件 * Check if an entity matches this system's query condition * * @param entity 要检查的实体 / The entity to check * @returns 是否匹配 / Whether the entity matches

(entity: Entity)

     * @returns 是否匹配 / Whether the entity matches
     */
    public matchesEntity(entity: Entity): boolean {
        if (!this._matcher) {
            return false;
        }

        // nothing 匹配器不匹配任何实体
        if (this._matcher.isNothing()) {
            return false;
        }

        // 空匹配器匹配所有实体
        if (this._matcher.isEmpty()) {
            return true;
        }

        const condition = this._matcher.getCondition();

        // 检查 all 条件
        for (const componentType of condition.all) {
            if (!entity.hasComponent(componentType)) {
                return false;
            }
        }

        // 检查 any 条件
        if (condition.any.length > 0) {
            let hasAny = false;
            for (const componentType of condition.any) {
                if (entity.hasComponent(componentType)) {
                    hasAny = true;
                    break;
                }
            }
            if (!hasAny) {
                return false;
            }
        }

        // 检查 none 条件
        for (const componentType of condition.none) {
            if (entity.hasComponent(componentType)) {
                return false;
            }
        }

        // 检查 tag 条件
        if (condition.tag !== undefined && entity.tag !== condition.tag) {
            return false;
        }

        // 检查 name 条件
        if (condition.name !== undefined && entity.name !== condition.name) {
            return false;
        }

        // 检查单组件条件
        if (condition.component !== undefined && !entity.hasComponent(condition.component)) {
            return false;