应放弃轮询，改用各平台原生异步事件机制：windows用peekmessage/wm_input，macos用cgeventtapcreate+nsevent，linux用libevdev+inotify，统一转换后投递至线程安全队列。
输入事件怎么从操作系统捞上来，而不是靠轮询
Windows、macOS、Linux 的原生输入事件机制完全不同，但共同点是：都提供异步事件通知能力。手写跨平台输入系统的第一原则是放弃 GetAsyncKeyState 或 poll() 这类轮询，改用事件驱动——否则无法低延迟响应手柄热插拔、也无法准确捕获组合键释放顺序。
实际做法是：在各平台分别对接原生事件循环入口（Windows 的 PeekMessage/WM_INPUT；macOS 的 CGEventTapCreate + NSEvent 监听；Linux 的 libevdev + inotify 监控 /dev/input/event*），统一转换为内部事件结构体，再投递到一个线程安全的队列。不要试图用 SDL 或 GLFW 封装层——它们抽象掉太多细节，比如 Linux 下多个手柄共用一个 evdev 设备节点时的逻辑分离，就得自己处理。
手柄映射必须分两层：物理设备层 + 逻辑动作层
直接把 XInputGetState 的 bLeftTrigger 绑定到“跳跃”是错的。不同手柄的触发器范围、死区、校准方式差异极大，Xbox 手柄的 LT 是 0–255，而 PS5 手柄的 L2 是 0–1023，Switch Pro 的 ZL 则是浮点 0.0–1.0。硬编码映射会导致同一动作在不同设备上灵敏度断层。
推荐结构：
- 物理层：每个接入的手柄维护独立的
DeviceState，记录原始轴值、按钮位图、电池状态、GUID - 逻辑层：定义一组命名动作（如
"move_x","jump","menu_confirm"），通过 JSON 配置文件绑定到具体设备的物理输入（例如{"device": "0x054c:0x0ce6", "axis": 4, "deadzone": 0.15}） - 运行时查表：输入更新后，先归一化物理值（映射到 [-1.0, 1.0]），再按当前配置应用死区与曲线（如平方压缩以提升小幅度操作精度）
鼠标相对模式在 macOS 和 Wayland 下容易失效
Windows 的 SetRawInputBuffer 和 X11 的 XChangePointerControl 能稳定启用鼠标相对位移，但 macOS 的 CGAssociateMouseAndMouseCursorPosition 在沙盒应用中被禁用，Wayland 则根本不允许客户端接管光标——libinput 只向 compositor 上报事件，游戏进程拿不到原始 delta。
可行方案只有两个：
- macOS：用
IOHIDManager直接读取 HID 鼠标设备（需用户授权“辅助功能”权限），绕过事件系统获取原始kIOHIDElementValue - Wayland：依赖
wp-relative-pointer和wp-pointer-constraints协议扩展，且必须在初始化阶段就向 compositor 申请权限；失败时降级为屏幕中心重置 + 计算偏移（会受多显示器 DPI 不一致影响） - 所有平台都应缓存上一帧鼠标位置，用差值计算 delta，避免因事件丢失或重排序导致视角突变
键鼠与手柄共存时的冲突判定很关键
玩家可能同时用键盘 WASD 移动、手柄右摇杆转向、鼠标控制镜头——这没问题；但若键盘按了 W，手柄又推了左摇杆前向，系统不能简单加总，否则角色会超速。更麻烦的是“释放优先级”：手柄松开摇杆后，键盘方向键仍按着，该不该继续移动？
解决方法不是写一堆 if-else，而是引入输入源权重和生命周期标记：
- 为每种输入源分配权重（键盘=100，手柄=90，鼠标=80），同名动作只采纳最高权重源的值
- 每个动作记录最后更新时间戳，若某源超过 100ms 无更新，自动标记为“已退出”，不参与后续竞争
- 对“瞬时动作”（如跳跃、射击）额外加锁：一旦某源触发，其他源在 200ms 内的同名动作被忽略，防止误触
这套逻辑必须在输入事件队列消费线程里原子执行，不能分散到各个模块去各自判断——否则帧间状态不一致，调试时你会看到角色突然滑步或镜头抽搐。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
