Ubuntu 23.10下Gnome Terminal中XLib虚拟按键失效问题求助

我用C语言编写了一个模拟按键的程序，当记事本等编辑器窗口激活时按键功能正常，但切换到Gnome Terminal窗口时无任何输出。我的核心目标是将串口键盘发送的ASCII字符转换为标准按键，实现一个完整可用的自定义键盘。

测试代码如下：

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

#include <X11/Xlib.h>
#include <X11/keysym.h>
#include <X11/extensions/XTest.h>
#include <X11/Xutil.h>

int main() {
    while(1) {
        Display *display;
        unsigned int keycode;

        display = XOpenDisplay(NULL);
        keycode = XKeysymToKeycode(display, XK_C);
        XTestFakeKeyEvent(display, keycode, True, 0);
        XTestFakeKeyEvent(display, keycode, False, 0);
        XFlush(display);
        sleep(5);
    }

    return 0; 
}

原因分析 #

Gnome Terminal基于VTE组件，在Ubuntu 23.10中默认启用了输入捕获安全机制，会拒绝XTest这类模拟输入请求，防止恶意程序注入。另外，原代码每次循环重新打开Display连接，不仅效率低下，还可能导致权限上下文丢失。

解决方案 #

1. 赋予程序输入模拟权限 #

Ubuntu下需要给程序赋予对应权限，可通过两种方式实现：

• 使用setcap为程序添加权限：

  sudo setcap cap_sys_tty_config+ep ./your-program-binary
  

• 将当前用户加入input组（需重新登录生效）：

  sudo usermod -aG input $USER
  

2. 修改代码复用Display连接 #

将Display初始化移到循环外，避免重复打开连接导致的问题，同时增加错误处理：

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

#include <X11/Xlib.h>
#include <X11/keysym.h>
#include <X11/extensions/XTest.h>
#include <X11/Xutil.h>

int main() {
    // 初始化Display连接，只做一次
    Display *display = XOpenDisplay(NULL);
    if (!display) {
        fprintf(stderr, "无法打开X Display\n");
        return EXIT_FAILURE;
    }

    unsigned int keycode = XKeysymToKeycode(display, XK_C);
    if (keycode == 0) {
        fprintf(stderr, "无法获取按键对应的keycode\n");
        XCloseDisplay(display);
        return EXIT_FAILURE;
    }

    while(1) {
        // 使用CurrentTime而非0，确保事件时序正确
        XTestFakeKeyEvent(display, keycode, True, CurrentTime);
        XTestFakeKeyEvent(display, keycode, False, CurrentTime);
        XFlush(display);
        sleep(5);
    }

    // 实际不会执行到这里，仅作规范
    XCloseDisplay(display);
    return EXIT_SUCCESS; 
}

3. 禁用Gnome Terminal的输入安全限制（可选，不推荐） #

若仅用于测试，可临时关闭Terminal的安全检查：

• 图形界面：打开Gnome Terminal → 偏好设置 → 通用 → 勾选“允许来自X11的模拟输入”
• 命令行启动：

  gnome-terminal --disable-fake-input-check
  

注意：此方法会降低系统安全性，不建议在生产环境使用。

内容的提问来源于stack exchange，提问作者Dracula D