Godot 输入处理：用 InputMap 动作…

在 Godot 中搭建玩家控制、输入系统或添加手柄/可访问性支持时，按场景加载对应脚本并遵循输入传播、InputMap、死区与缓冲规范。

适用场景

解决思路

1. 按场景加载脚本：跳跃/冲刺/土狼时间手感用 input_buffer.gd（物理帧衰减）+ advanced_input_buffer.gd（多动作优先级）；设置重绑定 UI 用 safe_runtime_rebind.gd（ConfigFile 持久化到 user://）；摇杆移动用 analog_deadzone_manager.gd（绝不在无径向死区时直接读原始轴）；“按 X / 按 E”提示用 glyph_prompt_manager.gd；UI 导航与游戏确认区分用 input_echo_filter.gd；游戏与菜单点击区分用 unhandled_input_priority.gd。
2. 按场景避免加载无关脚本：设置重绑定 UI 不加载 multi_touch_gestures.gd、mouse_capture_manager.gd、连招/回放注入器；移动/触摸手势不加载 mouse_capture_manager.gd 与桌面重绑定持久化；仅跳跃/冲刺缓冲不加载重绑定、多点触控、回放、连招校验；FPS 鼠标视角不加载 multi_touch_gestures.gd、连招/回放；连招/格斗序列不加载触摸手势、鼠标捕获；回放/虚拟注入测试不加载重绑定 UI、多点触控。
3. 绝不在 _process() 中轮询游戏动作输入——使用 _physics_process() 或 _unhandled_input()，因为 _process() 依赖帧率，低 FPS 时会丢输入。
4. 绝不用硬编码按键检查（如 KEY_W）——始终使用 InputMap 动作，硬编码按键会阻止重绑定并破坏非 QWERTY 布局兼容性。
5. 绝不忽略摇杆死区——0.05 幅度的漂移会导致意外移动，必须在代码或设置中实现径向死区（而非轴向）。
6. 绝不假设只有单一输入设备——玩家可能在会话中切换键盘与手柄，用 Input.joy_connection_changed 动态更新 UI 提示。
7. 绝不用 _input() 处理游戏动作——_input() 会对所有事件（含 UI）触发，应使用 _unhandled_input() 避免点击菜单时触发游戏逻辑。
8. 绝不在快节奏游戏中省略输入缓冲——若玩家在落地前 50ms 按跳跃，无缓冲则输入丢失，实现 100-150ms 缓冲以获得“紧致”手感。
9. 绝不用 Input.is_action_pressed() 处理一次性触发——它在按键按住期间每帧返回 true，跳跃、攻击、切换应使用 _just_pressed 避免逻辑重复触发。
10. 绝不在多处实现手动的“按住 vs 切换”逻辑——集中到设置或输入包装器中，确保全游戏可访问性一致。
11. 绝不忘记在 UI 导航中处理 InputEvent.is_echo()——回声事件（键盘重复）应移动菜单，但很少应触发“确认”或“返回”动作。
12. 绝不在没有“释放”快捷键的情况下捕获鼠标——若游戏崩溃或阻塞 ui_cancel，用户会被困住，始终为鼠标捕获提供后备退出方式。
13. 理解输入传播顺序以隔离 UI 与游戏：_input(event) 为高优先级全局拦截（用于开发控制台或调试覆盖层）；_gui_input(event) 由 Control 节点（UI）处理，若 UI 元素消费事件（如点击按钮）会调用 accept_event() 停止传播；_unhandled_input(event) 仅在没有 UI 元素消费事件时到达，所有游戏逻辑（跳跃、射击）应放在这里以防与菜单交互时误触发。
14. InputMap 最佳实践：避免物理按键检查，在 Project Settings > Input Map 中定义语义动作（如 move_left、interact）。
15. 模拟摇杆死区：必须使用 analog_deadzone_manager.gd，优先用 Input.get_vector() 实现圆形死区——绝不将各轴相减成方形死区。
16. 专家轮询增量（无硬编码按键）：游戏在 _physics_process / _unhandled_input 中采样动作——绝不用 KEY_* / MOUSE_BUTTON_* 分支；暂停/取消必须是 InputMap 动作（如 ui_cancel），以便重绑定和非 QWERTY 布局生效，参见 unhandled_input_priority.gd。
17. 多模态输入处理：鼠标瞄准在 _unhandled_input() 中处理 InputEventMouseMotion 相对移动（mouse_capture_manager.gd）；摇杆移动在 _physics_process() 中经 analog_deadzone_manager.gd 后轮询向量。
18. 动态图标切换：必须使用 glyph_prompt_manager.gd 实现按最后活跃设备切换提示，不要在每个 HUD 控件中手写 event is InputEventJoypadButton 检测器。
19. 输入缓冲必须使用 input_buffer.gd + advanced_input_buffer.gd，不要内联粘贴跳跃计时器教程代码。
20. 土狼时间由移动类技能负责：godot-characterbody-2d（frame_perfect_coyote_time.gd）与 godot-genre-platformer，与本技能的缓冲配对使用，不要在此重新实现土狼时间。
21. 多人输入同步：不要在此 RPC sync_input，路由到 godot-multiplayer-networking 做权威动作快照 / get_remote_sender_id 校验。
22. 虚拟注入必须使用 virtual_input_injector.gd（Input.parse_input_event）。
23. 连招序列必须使用 combo_validator.gd；格斗设定留在 godot-genre-fighting。
24. 确定性回放必须使用 input_replay_buffer.gd。
25. 按需查阅深度配方：缓冲/土狼/多人同步见 references/input-event-processing.md；虚拟注入/连招/回放见 references/expert-input-extensions.md；InputMap 与设备 ID 见 references/inputmap-best-practices.md。
26. 渐进式披露：仅在研究特定 API 时打开官方文档链接；路由到同级领域时加载相关技能——不要预加载整个技能网络。

适用边界 · 注意事项

• 非 Godot 引擎项目不适用。
• 不涉及玩家输入、手柄、重绑定或可访问性输入需求的项目不适用。
• 需要多人权威输入同步、格斗连招设定或土狼时间实现时，应路由到对应专门技能而非本技能。