自定义行为树任务节点必须继承UBTTaskNode而非UBehaviorTreeTaskNode，且需设置bCreateNodeInstance=true；ExecuteTask()返回InProgress才触发TickTask()；须通过OwnerComp.GetAIOwner()安全访问AI与黑板。
为什么继承 UBTTaskNode 而不是 UBehaviorTreeTaskNode
Unreal Engine 5 中真正可被行为树编辑器识别并拖入的自定义任务节点，必须直接或间接继承 UBTTaskNode（它本身已继承自 UBehaviorTreeTaskNode）。如果误继承 UBehaviorTreeTaskNode，编译后节点不会出现在行为树面板中，且无任何报错提示——这是最常踩的坑。
正确做法是：在头文件中声明类时，明确写 class UMyBTTask : public UBTTaskNode；并在构造函数中调用 bCreateNodeInstance = true（否则运行时不会实例化）。
常见错误现象：MyBTTask 类已编译成功，但在 Behavior Tree 编辑器里搜索不到该节点名称——大概率是继承链或 bCreateNodeInstance 设置问题。
EBTNodeResult::Type ExecuteTask() 的返回逻辑怎么写
这个函数是任务执行的核心入口，返回值决定行为树下一步走向：EBTNodeResult::Succeeded 表示完成，EBTNodeResult::Failed 表示失败，EBTNodeResult::Aborted 表示被中断（比如高优先级任务插入），而 EBTNodeResult::InProgress 表示任务尚未结束、需持续 Tick。
关键点在于：只有返回 InProgress 时，引擎才会后续调用 TickTask()；否则该任务立即退出，TickTask() 不会被调用。
- 同步任务（如播放音效、设置变量）：直接在
ExecuteTask()里做完，返回Succeeded或Failed - 异步任务（如移动到目标点、等待延迟）：在
ExecuteTask()中初始化逻辑（如启动计时器、调用MoveToLocation()），然后返回InProgress；再靠TickTask()检查状态 - 务必在
AbortTask()中清理资源（如清除计时器、停止移动），否则可能引发崩溃或逻辑错乱
如何在任务中安全访问 AIController 和 Blackboard
不能直接用 GetWorld()->GetFirstPlayerController() 这类全局查找——行为树任务必须绑定到具体 AI 实例。正确路径是：通过 OwnerComp.GetAIOwner() 获取所属的 AIController，再从中取 GetBlackboardComponent()。
示例代码片段：
UBlackboardComponent* BB = OwnerComp.GetAIOwner()->GetBlackboardComponent();
if (BB && BB->GetValueAsVector(TEXT("TargetLocation")) != FVector::ZeroVector) {
// 安全读取
}
容易忽略的风险点：
-
OwnerComp.GetAIOwner()可能为空（比如任务在非 AI 场景下被误触发），必须判空 -
BB->GetValueAsXxx()若 Key 不存在或类型不匹配，会返回默认值且不报错——建议配合BB->IsKeyValid(BlackboardKey)预检 - Blackboard Key 必须在 Behavior Tree 资源的
Blackboard Asset中预先声明，否则运行时读不到
蓝图与 C++ 混合使用时的常见陷阱
如果你把 C++ 自定义任务节点暴露给蓝图（加 UCLASS(Blueprintable)），然后在蓝图中重写 ReceiveExecuteAI，注意：C++ 的 ExecuteTask() 仍会先执行，之后才调用蓝图事件。两者不是替代关系，而是叠加调用。
这意味着：
- 若你在 C++
ExecuteTask()中已返回Succeeded，蓝图里的ReceiveExecuteAI实际不会被触发（因为任务已结束） - 若想完全交由蓝图控制逻辑，C++ 端应只做注册和转发，返回
InProgress并在TickTask()中调用ReceiveTickAI蓝图事件 - 蓝图中重写的事件函数名必须严格匹配（
ReceiveExecuteAI/ReceiveTickAI），大小写和参数都不能错，否则静默失效
调试时建议在 C++ 函数开头打日志（UE_LOG(LogTemp, Warning, TEXT("ExecuteTask called"))），确认执行流是否符合预期——很多“蓝图没反应”的问题，根源其实是 C++ 层提前结束了任务。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
