X11/Xlib下根窗口KeyPress无响应、ButtonPress报错的事件读取实现

• 抛出BadAccess错误是X11协议的硬限制：同一个窗口的同一类事件掩码，同一时刻只能被一个客户端注册监听。i3作为当前运行的窗口管理器，启动时就为了处理桌面点击、工作区切换、焦点跳转这些基础功能，已经把根窗口的ButtonPressMask监听权限占了。你在程序里重复注册这个掩码时，X服务器的冲突检查直接不通过，就会报这个错，不是你代码逻辑有问题。
• 收不到KeyPress事件的核心是X11的默认事件路由逻辑：键盘按下事件只会派发给当前持有键盘焦点的窗口。在被窗口管理器接管的桌面里，根窗口本身永远不会成为焦点持有者，就算你给根窗口开了KeyPressMask，事件根本没有触发派发的路径，自然等不到任何按键信号。

全程不需要做全局输入抓取，靠和窗口管理器的协作就能实现需求：

• 鼠标点击捕获：别硬抢根窗口的事件监听权限。直接走i3的IPC通道，程序启动时把自己的根窗口绘图区域注册成可接收输入的命中区，让i3做事件中转——当鼠标点击落在你定义的绘图范围内时，i3把对应的ButtonPress事件转发给你的程序，而不是自己处理掉。这种方式只会路由你绘图区域内的点击事件，不会拦截其他位置的鼠标操作。
• 键盘按键捕获：同样走协作路径，两种方案可以根据自己的需求选：
  • 程序启动时给自己关联的根窗口输入子窗口主动申请键盘焦点，X服务器就会把后续的按键事件直接派发给你的程序，全程只接收当前焦点下的按键，不会干扰其他窗口的输入逻辑。
  • 如果你只需要监听特定的几个按键，可以通过i3的配置接口把这些按键设成透传规则：让i3收到这类按键时不触发自身的快捷键逻辑，直接转发给绑定的根窗口客户端。这种方式仅针对你指定的按键做事件透传，不会捕获全局所有键盘输入。
• 避坑提醒：别为了抢事件权限，直接调XGrabKey、XGrabButton去抓根窗口的全量输入，这类实现就是你之前判断过的全局全量输入hook路径，不仅会拦截系统所有窗口的对应输入，还会和i3已有的事件抓取规则冲突，触发更多未知的X错误。

内容的提问来源于stack exchange，提问作者Nicholas Ficara