自动关联目录：反射与 UHT

反射解决的是一个 C++ 天生做不到的事：让程序在运行时知道自己的类型结构。C++ 没有反射，所以 UE 自己造了一套——办法是在编译前先扫一遍你的头文件，生成描述类型的 C++ 代码。

一句话定位：你写的 UCLASS / UPROPERTY 不是给编译器看的，是给 UHT 看的；编译器看到的是 UHT 生成出来的那份代码。

理解这一点，就能解释本页所有的"为什么不能这么写"。

流水线

你的 .h（带 UCLASS/UPROPERTY 宏）
        │  UHT（UnrealHeaderTool）扫描
        ▼
YourClass.generated.h  ──┐
YourClass.gen.cpp      ──┤
        │                │
        └────────────────┴──► 一起交给真正的 C++ 编译器
                              （UCLASS 宏此时展开为空或普通结构体）

所以每次"改了头文件但行为没变"，第一反应应该是：UHT 有没有重新跑。

各宏的作用

没有 GENERATED_BODY()，UHT 生成的代码就接不进来，表现为编译期一堆"找不到 StaticClass"。

UPROPERTY 说明符速查

对 GC 最关键的一条：UPROPERTY() 让这个指针成为 GC 的引用边。漏标 = 没有引用边 = 对象可能被回收（详见 GC 与对象生命周期）。

UFUNCTION 说明符速查

// BlueprintNativeEvent 的正确写法：实现的是 _Implementation，不是原函数
UFUNCTION(BlueprintNativeEvent)
void OnDamaged(float Amount);

void AMyActor::OnDamaged_Implementation(float Amount)   // 注意后缀
{
    Health -= Amount;
}

直接写 AMyActor::OnDamaged 会链接失败，因为声明已经被 UHT 改写成了 thunk，本体必须是 _Implementation。

头文件写法限制

UHT 是正则式扫描，不是完整的 C++ 解析器。下面是它处理不了的：

排错口诀：UHT 报错的行号经常不准，真正的问题通常在报错位置往上几行的宏写法上。

运行时怎么用反射

UClass* Cls = MyObject->GetClass();

// 遍历属性
for (TFieldIterator<FProperty> It(Cls); It; ++It)
{
    FProperty* Prop = *It;
    UE_LOG(LogTemp, Log, TEXT("%s : %s"), *Prop->GetName(), *Prop->GetCPPType());
}

// 按名字取属性并设置值（Int 为例）
if (FIntProperty* IntProp = FindFProperty<FIntProperty>(Cls, TEXT("Count")))
{
    IntProp->SetPropertyValue_InContainer(MyObject, 42);
}

// 按名字调函数
UFunction* Func = MyObject->FindFunction(TEXT("OnDamaged"));
if (Func) { MyObject->ProcessEvent(Func, &Params); }

TFieldIterator 默认包含父类字段。只想看本类声明的用 EFieldIteratorFlags::ExcludeSuper。

CDO：Class Default Object

CDO 是每个 UCLASS 在引擎启动时自动创建的一个"模板实例"，用于：

• 蓝图/编辑器里看到的"默认值"
• GetDefault<T>() 读配置与默认值
• 反序列化时作为基准（只存与 CDO 不同的字段，所以包体更小）

const UMySettings* Defaults = GetDefault<UMySettings>();
float Base = Defaults->BaseDamage;

构造函数只应该设置默认值，不要在里面做游戏逻辑——它在引擎启动、编辑器加载、CDO 构造时都会跑，远比你想的频繁。

代价

常见坑