Method removeComponent

packages/core/src/ECS/Entity.ts:623–654

* @zh 移除指定的组件 * @en Remove specified component * * @param component - @zh 要移除的组件实例 @en Component instance to remove

(component: Component)

     * @param component - @zh 要移除的组件实例 @en Component instance to remove
     */
    public removeComponent(component: Component): void {
        const componentType = component.constructor as ComponentType;
        const registry = this.scene?.componentRegistry ?? GlobalComponentRegistry;

        if (!registry.isRegistered(componentType)) {
            return;
        }

        const bitIndex = registry.getBitIndex(componentType);
        BitMask64Utils.clearBit(this._componentMask, bitIndex);
        this._componentCache = null;

        this.scene?.componentStorageManager?.removeComponent(this.id, componentType);
        this.scene?.referenceTracker?.clearComponentReferences(component);

        component.onRemovedFromEntity?.();
        component.entityId = null;

        if (this.scene?.eventSystem) {
            this.scene.eventSystem.emitSync('component:removed', {
                timestamp: Date.now(),
                source: 'Entity',
                entityId: this.id,
                entityName: this.name,
                entityTag: this.tag?.toString(),
                componentType: getComponentTypeName(componentType),
                component: component
            });
        }

        this.notifyQuerySystems(componentType);
    }

    /**
     * @zh 移除指定类型的组件