技能介绍

UE C++ 开发的几个高频坑

在虚幻引擎项目里写 C++，很多错误在编译期完全看不出来：UObject* 成员忘记加 UPROPERTY()，运行时被 GC 静默回收；在 Tick 里反复 Cast，帧率悄悄掉下去；用硬 TSubclassOf 引用大量资产，启动时卡在加载链上。另一个常见问题是凭命名习惯猜测引擎 API——比如以为某个类有对应的 Getter，实际上并不存在。这类问题在 GAS 相关的类（FGameplayAbilityActorInfo、FGameplayEffectSpec）上尤为常见，它们的访问模式与常规 UE 约定并不一致。

技能如何工作

这个技能的核心理念是零假设：不猜测项目结构、资产路径或已有 helper 函数，所有改动前先做 Pre-Flight 发现。

项目侦察：先定位 .uproject，从 EngineAssociation 字段确认引擎版本，检查已启用的插件和模块依赖，再梳理 Source/ 目录结构与 Content/ 资产。
先读后写：在给出任何代码建议前，先阅读已有的角色/控制器类，摸清命名约定（如 Input Action 的 IA_ 前缀）和组件使用方式。
代码质量准则：UPROPERTY() 包裹所有权指针，优先用 TObjectPtr<>；Tick 默认关闭，改用定时器或事件；热点路径缓存 Cast 结果；大资产用 TSoftClassPtr / TSoftObjectPtr。
按需加载参考：GAS、Enhanced Input、插件开发、数据驱动设计、调试等主题都有独立的参考文件，需要时再深入。

适用边界

仅面向 Unreal Engine 5.x，不适用于 4.27 以下或纯蓝图项目。
不会自动创建新的 UCLASS / USTRUCT 头文件与源文件——引擎生成的 GENERATED_BODY()、PROJECTNAME_API 等样板代码无法可靠手写复制，需要先在编辑器里用 New C++ Class 创建。
调用任何 helper 函数前会先在代码库里核实声明，不存在就直接用引擎 API，不会凭空发明调用。
修改任何 C++ 文件后，要求先跑通编译再继续，具体命令以项目 CLAUDE.md 为准。