Unreal C++ 游戏框架编程指南

UE5 的 C++ 游戏代码为什么难写对

在 UE5 里写游戏逻辑 C++，卡住人的往往不是语言本身，而是反射系统：UCLASS()、GENERATED_BODY()、Foo.generated.h 三件套缺一不可，类名前缀（A/U/F/E/I）必须与基类一致，漏掉任何一环都会在 UHT 处理或链接阶段直接报错。另一个高频问题是模块依赖——调用了 EnhancedInput 的 API 却没在 .Build.cs 里声明，链接期就会出现 unresolved external symbol。

这个技能覆盖什么

• 反射宏的正确用法：用 UPROPERTY 暴露属性（同时让 GC 能追踪），用 UFUNCTION 把行为暴露给编辑器和蓝图
• Gameplay Framework 角色分工：AGameModeBase 定规则和默认类，APawn/ACharacter 是受控身体，APlayerController 代表玩家意志，UActorComponent 是可复用行为
• 模块依赖配置：在 *.Build.cs 的 PublicDependencyModuleNames 中添加引擎模块

核心工作流

1. 按基类选前缀：Actor 系用 A，UObject/组件系用 U，普通结构体用 F
2. 类上方写 UCLASS()，GENERATED_BODY() 作为类体第一行，.generated.h 放在头文件最后一个 include
3. 构造函数里用 CreateDefaultSubobject 创建组件并设好 RootComponent
4. 编译验证：函数体改动可用 Live Coding，改头文件或 UPROPERTY 必须完整重建并确认编辑器中可见

适用边界与常见坑

它只管 C++ 类与反射层的基础，蓝图可视化逻辑、输入绑定、AI 逻辑请交给对应的技能。几个容易踩的坑：裸 UObject* 不加 UPROPERTY 会被 GC 误回收（UE5 里用 TObjectPtr）；重写 BeginPlay/Tick 忘记调用 Super:: 会跳过引擎初始化；改了 UCLASS/UPROPERTY 却只依赖 Live Coding，改动不会生效。