UI蓝图获取C++对象引用需先用UCLASS(BlueprintType)暴露类，变量用UPROPERTY(BlueprintReadWrite)声明，控件绑定用BindWidget；C++更新UI须持UUserWidget*指针并调用其函数，避免硬编码路径。
UI蓝图怎么拿到C++对象的引用
必须先让C++类暴露给蓝图系统，否则蓝图里根本找不到这个类。在头文件里加 UCLASS(BlueprintType) 或 UCLASS(Blueprintable)，同时确保类继承自 UObject（不是 AActor 也行，但得是 UObject 衍生类）。如果想从蓝图创建实例，还得加 BlueprintSpawnableComponent 或用 UWidgetComponent 挂载。
常见错误是只加了 UFUNCTION(BlueprintCallable) 却忘了类本身没暴露——这时候蓝图里搜不到类名，更别说拖引用了。
- 在C++类头文件中，
UCLASS()宏必须带BlueprintType或Blueprintable - 变量要暴露给蓝图，得用
UPROPERTY(BlueprintReadWrite)或BlueprintReadOnly - 如果想在UI蓝图中“拖拽赋值”，该变量类型必须是
UObject*子类（比如UPlayerState*、自定义的UGameInstanceSubsystem*） - Widget Blueprint 的
Event Construct里不能直接访问GetWorld()->GetGameInstance()——得用GetOwningPlayer()->GetGameInstance()，否则空指针
C++怎么主动更新UI蓝图里的控件
最稳的方式是：C++里持有 UUserWidget* 指针，在合适时机调用其公开函数。前提是这个Widget已实例化且未销毁——比如通过 CreateWidget 创建后存为成员变量，或从 GetOwningPlayer()->GetHUD() 取到。
别直接在C++里写 MyWidget->GetWidgetFromName(TEXT("TextBlock_0")) 这种硬编码路径，既脆弱又难维护。应该在UI蓝图里把关键控件设为变量（勾选 Is Variable），再在C++头文件里用 UPROPERTY() 声明同名变量绑定：
立即学习“C++免费学习笔记（深入）”；
UPROPERTY(BlueprintReadOnly, meta = (BindWidget)) UTextBlock* HealthText;
这样在C++中就能安全读写 HealthText->SetText(...)，引擎会自动绑定。
- 绑定控件前，确保UI蓝图中该控件的
Variable Name和C++中UPROPERTY声明的变量名完全一致（大小写敏感） - 绑定只在
OnInitialized或NativeConstruct后生效；Construct阶段控件尚未生成，此时访问为nullptr - 如果Widget被反复创建/销毁（如菜单切换），记得在
NativeDestruct里清空指针，避免悬空引用
蓝图调用C++函数时参数传不过去怎么办
典型现象：蓝图里拖出函数节点，填了参数，运行时C++函数里对应参数却是默认值或空。大概率是参数类型不匹配或未标记可蓝图访问。
基础规则很明确：所有传入/传出参数都必须是蓝图支持的类型，并显式标注。例如 FString 可以，std::string 不行；int32 可以，int 不行；自定义结构体必须加 USTRUCT(BlueprintType)。
- 函数声明必须带
UFUNCTION(BlueprintCallable)，且不能是const成员函数（蓝图调用会隐式传入this） - 参数需加
const&修饰减少拷贝，但引用类型必须是UObject派生类或蓝图原生类型（如const FString&合法，const FVector&也合法） - 返回值如果是自定义结构体，函数声明得加
BlueprintPure；若带副作用（如修改状态），就用BlueprintCallable并避免返回复杂类型 - 如果参数是数组，用
TArray<fstring></fstring>而非const TArray<fstring>&</fstring>——蓝图目前对 const 引用数组支持不稳定
为什么OnClicked事件在C++里收不到
UI蓝图里的按钮点击，默认只触发蓝图事件，不会自动通知C++。想在C++响应，有两个正路：一是用 BindDynamic 绑定委托，二是把按钮声明为 UPROPERTY 后手动绑定。
推荐后者：在UI蓝图中将按钮设为变量（Is Variable = true），C++头文件中声明：
UPROPERTY(meta = (BindWidget)) UButton* SubmitButton;
然后在 NativeConstruct 里写：
if (SubmitButton)
{
SubmitButton->OnClicked.AddDynamic(this, &UMyUserWidget::OnSubmitClicked);
}
注意：不要在 Construct 或 Event Construct 的蓝图侧调用C++函数来绑定——此时C++对象可能还没初始化完，this 是野指针。
-
AddDynamic必须在NativeConstruct或之后调用，不能早于控件绑定完成 - 如果按钮是动态生成的（比如循环创建多个），得在每次创建后单独绑定，不能只绑一次
- 绑定的函数签名必须严格匹配：返回
FReply，无参数（UButton::OnClicked是FOnClicked类型，参数为空） - Widget销毁前应在
NativeDestruct中调用OnClicked.RemoveAll(this)，否则可能 crash
虚幻里UI和C++通信不是单向桥接，而是靠双向绑定+生命周期同步撑起来的。最容易漏掉的是绑定时机和指针有效性检查——尤其在热重载、关卡切换、Widget复用场景下，nullptr 出现得比预期频繁得多。
