自动关联目录：组件与世界

组件是 UE 的组合机制：Actor 提供"在世界里存在"的能力，组件提供"具体能做什么"。而 World / Level 是 Actor 存在的容器。

一句话定位：Actor 是容器与网络身份，组件是功能与世界变换；能不能拿到 World 决定了你能不能访问游戏状态。

组件体系

UActorComponent            （功能：无变换）
   └── USceneComponent     （有 Transform，可挂载形成树）
          └── UPrimitiveComponent   （有渲染/碰撞体）
                 └── UMeshComponent / USkeletalMeshComponent / UStaticMeshComponent

判断标准很简单：这个东西有没有位置？没有 → UActorComponent。有 → USceneComponent。需要被看到/碰撞 → UPrimitiveComponent。

选错的代价：UActorComponent 挂不了子物体；UPrimitiveComponent 会参与碰撞查询与渲染，纯逻辑用它白白增加开销。

创建与注册

// 构造函数里：默认子对象，编辑器可见
Mesh = CreateDefaultSubobject<USkeletalMeshComponent>(TEXT("Mesh"));
Mesh->SetupAttachment(RootComponent);        // 挂到根

// 运行时：手动创建
UMyComp* C = NewObject<UMyComp>(this);
C->RegisterComponent();                       // 必须，否则不 Tick、不复制
C->AttachToComponent(RootComponent, FAttachmentTransformRules::KeepRelativeTransform);

运行时创建组件忘记 RegisterComponent 的表现：不 Tick、不渲染、不复制，但对象存在——非常难查。

组件复制

UMyComp::UMyComp()
{
    SetIsReplicatedByDefault(true);   // 或运行时 SetIsReplicated(true)
}

查找组件

// 缓存引用（推荐）
UPROPERTY()
UMyComp* Cached;

// 按类查找（有开销）
UMyComp* C = FindComponentByClass<UMyComp>();
TArray<UMyComp*> All;
GetComponents<UMyComp>(All);

FindComponentByClass 每次都遍历数组，热路径上应该缓存指针或用 UPROPERTY 引用。

World / Level 层次

UGameInstance（跨关卡，进程级）
   └── UWorld（一个世界）
          ├── PersistentLevel（持久关卡）
          ├── StreamingLevel 1..N（子关卡）
          └── 所有 Actor

UWorldSubsystem 的生命周期跟随 World，UGameInstanceSubsystem 跟随 GameInstance——选错了就会出现"切场景后数据没了"。

GetWorld 的坑

UWorld* W = GetWorld();   // UObject 的虚函数

"GetWorld 返回 null" 的前三名原因：在构造函数里调、在 CDO 上调、对未注册的对象调。

世界级服务放哪

不要用静态单例（理由见 模块插件与 Subsystem）。

常见坑