《Unreal 对 C++ 做了什么》系列 06. UE 的枚举与接口：UENUM 和 UINTERFACE-平芜编程栈

《Unreal 对 C++ 做了什么》系列 (06/54)

06. UE 的枚举与接口：UENUM 和 UINTERFACE 🧩

🚀 导言：填补原生 C++ 的设计鸿沟

在标准 C++ 中，枚举和接口（纯虚类）是基础中的基础。但它们在大型引擎开发中存在两个致命弱点：

枚举不可读：原生枚举在运行时只是整数，无法直接在编辑器下拉菜单中显示名字，也无法轻松转换为字符串。
接口多继承困境：UObject体系严禁多重继承，这使得标准的 C++ 纯虚类接口无法被反射系统识别，也无法在蓝图中使用。

UE 通过UENUM和UINTERFACE重新改造了这两个概念，让它们完美融入反射与蓝图系统。

🔑 UENUM：赋予整数以“语义”

在 UE 中，我们几乎不再使用原生的enum，而是强制使用enum class并配合UENUM宏。

1. UE 对枚举做了什么？

字符串映射：UHT 为每个枚举值生成元数据。你可以通过UEnum::GetValueAsString在运行时直接获取枚举值的名字（如 “EStatus::Active”）。
编辑器显示：通过DisplayName元数据，你可以让代码里的枚举值在编辑器中显示为易读的中文或详细描述。

2. 代码演示

// 头文件声明UENUM(BlueprintType)enumclassEPlayerStatus:uint8{IdleUMETA(DisplayName="待机状态"),RunningUMETA(DisplayName="奔跑中"),JumpingUMETA(DisplayName="跳跃中"),};

🔗 UINTERFACE：解决多继承的“双生类”模式

这是 UE 对 C++ 做的最复杂的改动之一。为了让UObject既能保持单继承的轻量性，又能拥有接口的多态性，UE 采用了**“双生类”结构**。

1. 核心架构：U 类与 I 类

当你声明一个接口时，UHT 会强制要求你定义两个类：

UInterfaceName：这是反射系统的载体。它继承自UInterface，不含任何逻辑，仅用于让引擎知道“这是一个接口”。
IInterfaceName：这是真正的 C++ 接口。它包含函数声明，是你代码中实际继承并实现的部分。

2. 为什么蓝图能调用 C++ 接口？

UE 引入了特殊的Execute_前缀函数。如果一个接口函数标记了BlueprintNativeEvent，你不能直接调用InterfacePtr->Func()，而必须通过IInterfaceName::Execute_Func(ObjectPtr)。这样引擎才能在运行时判断：“这个接口是由 C++ 实现的，还是由蓝图动态实现的？”

💻 代码实战：定义与实现接口

1. 声明部分 (Interactable.h)

UINTERFACE(MinimalAPI,Blueprintable)classUInteractable:publicUInterface{GENERATED_BODY()};classIInteractable{GENERATED_BODY()public:// 纯 C++ 接口函数virtualvoidNativeInteract()=0;// 蓝图可重写的接口函数UFUNCTION(BlueprintNativeEvent,BlueprintCallable,Category="Interaction")voidOnInteract(AActor*Interactor);};

2. 实现部分 (MyActor.h & .cpp)

// 继承接口classAMyChest:publicAActor,publicIInteractable{GENERATED_BODY()public:// 实现 C++ 原生接口virtualvoidNativeInteract()override{/* 逻辑 */}// 实现带反射的接口逻辑virtualvoidOnInteract_Implementation(AActor*Interactor)override{/* 逻辑 */}};

📊 核心对比：标准 C++ vs. 虚幻 C++

特性	标准 C++	虚幻 C++
枚举反射	无，需手动写 switch-case 转字符串	UENUM自动生成字符串映射
枚举展示	只能显示代码变量名	支持UMETA(DisplayName)编辑器友好显示
多继承支持	允许，但易产生“钻石继承”问题	严禁，通过UINTERFACE规避
接口调用	直接虚函数调用	支持Execute_模式，兼容蓝图/C++ 混合调用
转换安全性	`dynamic_cast`(性能差/需开启 RTTI)	Cast(基于反射，极快且安全)

⚠️ 使用陷阱

枚举底层类型：UENUM必须基于uint8。如果你的枚举超出了 255 个值，UE 将无法正常反射它。
接口类型转换：在 UE 中转换接口时，一定要使用Cast<IInteractable>(Object)。如果你使用原生 C++ 的static_cast，在处理蓝图实现的接口时会发生内存错误。
不要在接口中定义属性：接口只能包含函数。如果你需要变量，请使用UCLASS或USTRUCT。