Unreal Engine 中的反射：类型系统如何工作

虚幻引擎反射系统：运行时类型处理详解

虚幻引擎依赖其内置反射系统，在运行时获取类型信息。这驱动了对象序列化、编辑器属性显示、C++与蓝图集成以及网络通信等核心功能。该系统基于虚幻头文件工具（UHT）的代码生成，并采用双平行类型层次结构。

反射架构：UHT与生成文件

虚幻头文件工具（UHT）会扫描C++头文件，识别UCLASS和UPROPERTY等宏，并生成注册类型的代码。这会产生两个关键文件：

• .generated.h — 包含宏定义和前向声明。
• .gen.cpp — 包含类型注册代码，可能长达数千行。

生成代码存储属性名称、标志和内存偏移等元数据。例如，FAbilityAttribute中的CurrentValue属性的偏移通过STRUCT_OFFSET注册，让引擎能在运行时直接访问数据。

双类型层次结构：UObject与FField

UE5采用两种类型描述系统，按性能优化进行拆分。

基于UObject的层次结构

由垃圾回收器管理，包括：

• UClass，用于C++类。
• UFunction，用于函数。
• UScriptStruct，用于结构体。
• UEnum，用于枚举。

基于FField的层次结构

UE 4.25引入，用于降低开销，此处属性跳过垃圾回收：

• FField — 基类。
• FProperty — 描述单个属性，如FIntProperty或FFloatProperty。
• 层次间链接：UStruct持有指向FField属性链表的指针。

FField关键特性：

• 使用链表存储子元素。
• FFieldClass支持位掩码快速类型转换。
• FFieldVariant结合UObject和FField指针，利用最低位区分类型。

FProperty剖析：数据访问机制

FProperty提供内存中属性操作工具。核心元素：

• Offset_Internal — 属性内存偏移，由STRUCT_OFFSET计算。
• EPropertyFlags — 控制行为的标志，如CPF_Edit用于编辑器调整。
• 访问方法如ContainerPtrToValuePtr，支持直接读写。

实际示例：

UAbilityComponent* Comp = ...;
FProperty* HealthProp = Comp->GetClass()->FindPropertyByName(TEXT("HealthAttribute"));
FAbilityAttribute* HealthPtr = HealthProp->ContainerPtrToValuePtr<FAbilityAttribute>(Comp);
float CurrentHealth = HealthPtr->CurrentValue;

反射系统的实用应用

虚幻引擎反射系统驱动多项关键功能：

• 序列化 — 从文件保存和加载对象。
• 编辑器 — 在细节面板显示属性，支持分类和自定义控件。
• 蓝图集成 — 将C++属性和函数暴露给可视化脚本。
• 网络复制 — 客户端与服务器间数据同步。
• 垃圾回收 — 追踪对象所有权，实现内存管理。

核心要点

• 虚幻引擎反射依赖UHT代码生成，而非原生C++特性。
• UObject与FField层次拆分提升性能和内存效率。
• FProperty中的内存偏移实现快速运行时数据访问。
• 该系统支撑序列化、编辑和网络等引擎核心功能。
• 掌握反射对构建技能组件或自定义编辑器工具至关重要。

— Editorial Team