应在APlayerController子类的SetupInputComponent()中绑定输入动作，声明UPROPERTY引用UInputAction资产，调用BindAction并检查指针有效性，避免在GameMode或Pawn中绑定。
UE5 C++ 中如何在 GameMode 或 PlayerController 里绑定输入事件
虚幻引擎的输入绑定不是靠写 OnKeyPressed 这类回调函数实现的，而是通过“输入映射上下文（Input Mapping Context）+ 输入动作（Input Action）”在蓝图或 C++ 中注册后，再由引擎自动分发。C++ 层真正要做的，是声明输入动作、注册到上下文、并绑定响应函数。
最常用且稳定的做法是在 APlayerController 子类中处理——因为输入逻辑天然属于玩家控制范畴，GameMode 不直接接收输入事件。
- 确保你的
APlayerController子类在项目启动时被使用（检查DefaultGameMode的PlayerControllerClass配置） - 在
SetupInputComponent()函数中绑定，而不是构造函数或BeginPlay()—— 否则InputComponent可能为空或未就绪 - 必须调用父类实现：
Super::SetupInputComponent();，否则默认移动/摄像机逻辑会丢失 - 绑定时优先用
BindAction()（针对事件型输入，如按键按下/释放），不用BindAxis()（仅用于模拟摇杆、鼠标移动等连续值）
怎么声明和绑定一个 InputAction（比如 Jump）
不能直接在 C++ 里“创建”一个 UInputAction 资源——它必须是资产（/Game/Input/IA_Jump），并在项目设置或运行时加载。常见做法是：先在编辑器里新建 InputAction 资产，然后在 C++ 中声明 UPROPERTY 引用它。
示例代码片段（在 MyPlayerController.h 中）：
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Input") UInputAction* IA_Jump;
然后在 SetupInputComponent() 中绑定：
if (IA_Jump && InputComponent)
{
InputComponent->BindAction(IA_Jump, ETriggerEvent::Started, this, &AMyPlayerController::OnJumpStarted);
}
注意：ETriggerEvent::Started 对应按键按下瞬间；若需要长按持续触发，得用 ETriggerEvent::Triggered + 手动计时，引擎不会自动重复调用。
- 绑定前务必检查
IA_Jump是否非空，否则打包后可能崩溃（编辑器里拖了资源，但打包时没包含进 Cook 列表） - 如果用的是 UE5.3+ 的增强输入系统（Enhanced Input），这里要换成
UEnhancedInputLocalPlayerSubsystem注册，而非直接绑InputComponent - 函数签名必须严格匹配：
void AMyPlayerController::OnJumpStarted(const FInputActionValue& Value)，参数类型错会导致链接失败或静默不响应
为什么在 Pawn 或 Character 里绑定不了输入
APawn 和 ACharacter 默认没有 InputComponent，也不参与输入分发链。引擎只把输入事件派发给拥有激活 InputComponent 的 Actor，而只有 APlayerController（及其子类）默认启用并注册了输入组件。
- 试图在
ACharacter::SetupPlayerInputComponent()中绑定，编译能过，但运行时完全不触发——因为该函数根本不会被引擎调用 - 有人尝试手动 NewObject 一个
UInputComponent并 AddToRoot，这违反引擎输入生命周期管理，大概率导致崩溃或输入冲突 - 如果逻辑确实跟角色强相关（比如“使用交互物”），正确做法仍是：在
PlayerController中响应输入，再调用GetPawn()->CallFunction()或发事件到Character
打包后输入失效的三个高频原因
本地测试正常，打包后按键无反应，八成卡在这几个地方：
-
InputAction资产没设为“Include in Cooked Build”（右键资产 → Asset Actions → Add to Cooked Build） - C++ 类中声明的
UInputAction*成员变量没加UPROPERTY()宏，导致序列化失败，运行时指针为空 - 项目设置里的
Default Input Context没包含你用的InputMappingContext，或者没在UEnhancedInputLocalPlayerSubsystem中主动添加（Enhanced Input 下必须显式 Add）
尤其注意：UE5.1 之后默认启用 Enhanced Input，老项目升级容易漏掉子系统的初始化代码，这时候即使写了 BindAction 也完全没效果。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
