Unreal Engine：蓝图编辑器中获取USceneComponent全部子组件的入口点

问题本质 #

你遇到的核心问题是：编辑器中蓝图的组件实例是CDO（类默认对象），OnRegister/OnComponentCreated这类生命周期函数触发时，蓝图的子组件还未同步到CDO上；通过IDetailLayoutBuilder获取的对象要么是临时预览实例，要么是未同步子组件的旧CDO，自然拿不到子组件。

可行解决方案 #

1. 监听蓝图组件树变更委托 #

这是最可靠的方式，当蓝图编辑器的组件树发生添加/删除/修改操作时，直接从蓝图的GeneratedClass中获取最新的CDO，此时子组件已完全同步：

// 初始化时绑定委托（比如在编辑器模块StartupModule中）
FEditorDelegates::OnBlueprintComponentsModified.AddStatic(&FYourEditorUtility::OnBlueprintComponentsUpdated);

// 回调函数实现
void FYourEditorUtility::OnBlueprintComponentsUpdated(UBlueprint* InBlueprint)
{
    if (!InBlueprint || !InBlueprint->GeneratedClass) return;
    
    AActor* ActorCDO = InBlueprint->GeneratedClass->GetDefaultObject<AActor>();
    if (!ActorCDO) return;
    
    // 定位到你的目标USceneComponent
    USceneComponent* TargetComp = ActorCDO->FindComponentByClass<USceneComponent>();
    if (TargetComp)
    {
        TArray<USceneComponent*> ChildComps;
        TargetComp->GetChildrenComponents(true, ChildComps);
        // 这里可以拿到全部子组件，执行你的逻辑
    }
}

2. 修正自定义细节面板按钮的实现 #

如果要通过细节面板按钮触发，不能直接使用GetObjectsBeingCustomized返回的临时对象，必须从蓝图的GeneratedClass中获取最新CDO：

void FYourComponentDetailCustomization::CustomizeDetails(IDetailLayoutBuilder& DetailBuilder)
{
    TArray<TWeakObjectPtr<UObject>> SelectedObjs;
    DetailBuilder.GetObjectsBeingCustomized(SelectedObjs);
    
    if (SelectedObjs.Num() == 0) return;
    USceneComponent* TargetComp = Cast<USceneComponent>(SelectedObjs[0].Get());
    if (!TargetComp || !TargetComp->GetOwner()) return;
    
    // 获取所属Actor的蓝图对象
    UBlueprint* OwnerBlueprint = Cast<UBlueprint>(TargetComp->GetOwner()->GetClass()->ClassGeneratedBy);
    if (!OwnerBlueprint) return;
    
    // 添加自定义按钮
    DetailBuilder.AddCustomRow(FText::FromString("子组件操作"))
        .NameContent()[SNew(STextBlock).Text(FText::FromString("执行检查"))]
        .ValueContent()[
            SNew(SButton)
            .Text(FText::FromString("确认子组件"))
            .OnClicked_Lambda([OwnerBlueprint]()
            {
                AActor* LatestCDO = OwnerBlueprint->GeneratedClass->GetDefaultObject<AActor>();
                USceneComponent* UpdatedTarget = LatestCDO->FindComponentByClass<USceneComponent>();
                if (UpdatedTarget)
                {
                    TArray<USceneComponent*> ChildComps;
                    UpdatedTarget->GetChildrenComponents(true, ChildComps);
                    // 处理子组件逻辑
                }
                return FReply::Handled();
            })
        ];
}

3. 组件自身的生命周期备选方案 #

如果要在组件内部处理，可重写PostLoad或监听PostEditChangeProperty，但注意只有蓝图保存并重新加载后，CDO的PostLoad才会触发，不如组件变更委托实时：

void UYourSceneComponent::PostLoad()
{
    Super::PostLoad();
    
    TArray<USceneComponent*> ChildComps;
    GetChildrenComponents(true, ChildComps);
    if (ChildComps.Num() > 0)
    {
        // 执行操作
    }
}

关键提示 #

• 编辑器中不要依赖运行时的组件挂载逻辑，蓝图的组件层级存储在UBlueprint的ComponentTree中，最终同步到GeneratedClass的CDO上。
• 修改蓝图后，GeneratedClass会重新生成，必须重新获取CDO实例，避免使用旧的失效对象。

内容的提问来源于stack exchange，提问作者Jedi Knight