在Unreal Engine中，应继承UActorComponent创建自定义组件，通过暴露变量与函数供蓝图调用，支持构造时添加或运行时动态挂载，并可结合Gameplay框架扩展功能。
在Unreal Engine中，通过C++继承
UActorComponent
（而非直接使用UComponent，因UComponent是抽象基类）来创建自定义功能模块，是最标准、最灵活的方式。核心思路是：将游戏逻辑封装为可复用、可挂载、可蓝图调用的组件，再通过C++实现高性能或底层功能。
一、从UActorComponent派生你的自定义组件类
UActorComponent 是所有可附加到Actor上的功能组件的基类（如USceneComponent、UStaticMeshComponent等都继承自它）。你需要新建一个C++类，选择“Actor Component”作为父类：
在UE编辑器中右键 → “新建C++类” → 选择“Actor Component” → 命名为
UHealthComponent
（举例）
生成后，头文件中会自动包含
和
继承声明，并启用蓝图可访问（
）
在构造函数中调用
（如需每帧更新），并设置
（如需初始化逻辑）
二、添加变量与函数，并暴露给蓝图和编辑器
让组件真正“可用”，关键在于正确暴露接口：
用
暴露状态变量（如
），支持蓝图读写和细节面板显示
用
暴露功能函数（如
），供蓝图或其它C++代码调用
重写
处理组件挂载时的初始化（如绑定事件、获取引用）；重写
或
管理资源生命周期
三、在C++中动态添加/获取组件
组件可在运行时通过C++代码挂载到Actor上，无需编辑器拖拽：
C知道
CSDN推出的一款AI技术问答工具
下载
立即学习
“
C++免费学习笔记（深入）
”；
在Actor子类中（如
），使用
不适用——组件必须依附于Actor；应改用：
（仅限构造函数）
运行时添加：调用
，返回
，需
使用
获取已有组件：
或
四、结合Gameplay框架扩展更复杂功能
若需与Gameplay Ability System（GAS）、AttributeSet、GameplayEffect等协同，建议组件继承自
UGameplayTask
、
UGameplayAbility
或聚合
UAbilitySystemComponent
：
例如：自定义
可监听移动事件，触发音频+地面材质反馈
再如：
可封装射线检测、距离判定、交互提示逻辑，并通过
注册输入事件或Tick委托
注意：避免在组件中强持有Actor指针（易造成循环引用），优先使用
或通过
动态获取
UCLASS()UActorComponentBlueprintablePrimaryComponentTick.bCanEverTick = truebWantsInitializeComponent = trueUPROPERTY(BlueprintReadWrite, VisibleAnywhere)float CurrentHealthUFUNCTION(BlueprintCallable)void TakeDamage(float DamageAmount)InitializeComponent()OnRegister()OnUnregister()APlayerCharacterGetWorld()->SpawnActor() UHealthComponent* HealthComp = CreateDefaultSubobject(TEXT("HealthComp")); MyActor->AddComponentByClass(UHealthComponent::StaticClass(), true, FTransform::Identity, false);UActorComponent*Cast() UHealthComponent* Comp = MyActor->FindComponentByClass(); MyActor->GetComponentByClass(UHealthComponent::StaticClass());UFootstepAudioComponentUInteractionComponentBeginPlay()TWeakObjectPtrGetOwner()