Qt本身不提供跨平台全局键盘/鼠标钩子，Windows需用SetWindowsHookEx+DLL，Linux/macOS须绕过Qt事件循环，依赖X11、libevdev或CGEventTap等底层机制实现。
Qt 本身不提供跨平台的全局键盘/鼠标钩子能力，Windows 上必须调用 Win32 API 的 SetWindowsHookEx，Linux/macOS 则需绕过 Qt 自身事件循环，用底层机制（如 X11 或 evdev）——直接在 Qt 应用里“监听无焦点全局输入”本质上是脱离 Qt 事件系统的独立操作。
Windows 下必须用 SetWindowsHookEx + DLL 注入
Qt 的 QApplication::installEventFilter 或 qApp->notify 只能捕获本进程、有窗口句柄且已获得消息循环控制权的事件；无焦点时，系统根本不会把 WM_KEYDOWN 或鼠标消息派发给你的 Qt 窗口。真正可行的路径只有一条：在独立 DLL 中设置 WH_KEYBOARD_LL 或 WH_MOUSE_LL 钩子，并通过共享内存、命名管道或 Windows 消息（PostThreadMessage）把事件传回 Qt 主进程。
-
SetWindowsHookEx的回调函数必须在 DLL 中，不能在 EXE 的 Qt 主线程里直接注册——否则钩子会随线程退出失效 - 低级钩子（
LL后缀）不需要注入代码到目标进程，但 DLL 仍需被加载进每个桌面进程的地址空间（由系统自动完成） - Qt 主进程需创建一个隐藏窗口（
WinId()有效），用于接收 DLL 发来的自定义消息（如WM_USER + 100），避免用信号槽跨线程发事件引发崩溃 - 钩子 DLL 里不要调用任何 Qt 函数（包括
qDebug），否则可能引发 DLL 加载冲突或初始化失败
Linux 下无法靠 QApplication 实现，得用 libevdev 或 XRecord
Qt 在 Linux 默认走 X11 或 Wayland，但 X11 的 XGrabKey 仅对焦点窗口有效，Wayland 更是禁止全局抓取。真正能绕过窗口管理器监听物理输入的是：
- 用
libevdev直读/dev/input/event*设备节点——需 root 权限或用户加入input组，且要区分键盘/鼠标设备（libevdev_new_from_fd+libevdev_get_name） - 用 X11 的
XRecord扩展（仅限 X11 会话）：启动一个独立 X client，调用XRecordCreateContext监听全屏事件，再用XRecordEnableContext异步接收数据包——Qt 进程需用QSocketNotifier监听 X server 的连接 fd - Qt 6.5+ 的
QNativeInputEvent仅适用于本应用内原生事件，不是全局钩子
Qt 主进程如何安全接收外部输入事件
无论 Windows DLL 还是 Linux libevdev 线程，都不能直接调用 QObject::signal 或 QMetaObject::invokeMethod ——因为跨线程对象访问需严格满足 QObject 的线程亲和性规则。
- 推荐用
QMetaObject::invokeMethod配合Qt::QueuedConnection，但前提是目标QObject所在线程运行了事件循环（QThread::exec()） - 更稳妥的是用
QTimer::singleShot(0, ...)把处理逻辑推入目标线程事件队列，避免锁和竞态 - 若用共享内存（
QSharedMemory），需配QSystemSemaphore控制读写互斥，且注意结构体对齐（#pragma pack(1)） - 切勿在钩子回调中执行耗时操作（如文件写入、网络请求），否则会拖慢系统级输入响应，导致按键卡顿甚至死锁
真正的难点不在注册钩子，而在事件传递的线程安全与生命周期管理：DLL 卸载时机、libevdev 设备热插拔、X11 连接断开重连——这些都得自己兜底，Qt 不参与也不保护。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
