如何在Wayland环境下使用C++（Qt5）模拟键盘输入？

应用内模拟：Qt原生API实现 #

如果只需要在自己的Qt应用内部模拟键盘输入，直接用Qt的QKeyEvent和QCoreApplication::postEvent即可，无需依赖任何外部库，代码示例：

#include <QKeyEvent>
#include <QCoreApplication>

// 模拟按下并释放A键
void simulateKeyInApp(QWidget* targetWidget) {
    // 按下事件
    QKeyEvent pressEvent(QEvent::KeyPress, Qt::Key_A, Qt::NoModifier, "A");
    QCoreApplication::postEvent(targetWidget, &pressEvent);
    
    // 释放事件
    QKeyEvent releaseEvent(QEvent::KeyRelease, Qt::Key_A, Qt::NoModifier, "A");
    QCoreApplication::postEvent(targetWidget, &releaseEvent);
}

这个方案完全原生，不需要额外权限，仅对当前应用内的目标控件生效。

全局模拟：跨平台原生API实现 #

如果需要向系统内任意窗口模拟键盘输入，需调用各平台的原生系统API，以下是各平台的实现方案，均无需依赖外部工具或root权限（Wayland环境除外，见下文说明）：

Windows平台：使用SendInput API #

Windows提供的SendInput函数可以直接模拟全局键盘输入，无需管理员权限（除非目标窗口是高权限进程，如UAC弹窗），代码示例：

#include <windows.h>

void simulateGlobalKeyWin(WORD keyCode) {
    INPUT input[2] = {0};
    
    // 按下事件
    input[0].type = INPUT_KEYBOARD;
    input[0].ki.wVk = keyCode;
    
    // 释放事件
    input[1].type = INPUT_KEYBOARD;
    input[1].ki.wVk = keyCode;
    input[1].ki.dwFlags = KEYEVENTF_KEYUP;
    
    SendInput(2, input, sizeof(INPUT));
}

// 使用示例：模拟按下并释放A键
// simulateGlobalKeyWin(VK_A);

Linux平台：X11 XTest扩展 #

对于使用X11窗口系统的Linux环境，可借助XTest扩展实现全局模拟，无需root权限，编译时需链接Xtst库（编译参数加-lXtst -lX11），代码示例：

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

void simulateGlobalKeyX11(Display* display, KeyCode keyCode) {
    // 按下按键
    XTestFakeKeyEvent(display, keyCode, True, CurrentTime);
    // 释放按键
    XTestFakeKeyEvent(display, keyCode, False, CurrentTime);
    XFlush(display);
}

// 使用示例：
// Display* display = XOpenDisplay(nullptr);
// if (display) {
//     KeyCode aKey = XKeysymToKeycode(display, XK_a);
//     simulateGlobalKeyX11(display, aKey);
//     XCloseDisplay(display);
// }

注意：Wayland环境下X11 API不兼容，且Wayland没有统一的全局输入模拟API，普通用户权限下实现难度较高，若需支持Wayland，可能需要使用特定桌面环境提供的接口，但通常无需root权限。

macOS平台：Quartz Event Services #

macOS使用Quartz Event Services框架实现全局输入模拟，编译时需链接ApplicationServices框架，代码示例：

#include <ApplicationServices/ApplicationServices.h>

void simulateGlobalKeyMac(CGKeyCode keyCode) {
    // 按下按键
    CGEventRef pressEvent = CGEventCreateKeyboardEvent(nullptr, keyCode, true);
    CGEventPost(kCGHIDEventTap, pressEvent);
    CFRelease(pressEvent);
    
    // 释放按键
    CGEventRef releaseEvent = CGEventCreateKeyboardEvent(nullptr, keyCode, false);
    CGEventPost(kCGHIDEventTap, releaseEvent);
    CFRelease(releaseEvent);
}

// 使用示例：模拟按下并释放A键（CGKeyCode 0是A键）
// simulateGlobalKeyMac(0);

总结 #

• 应用内模拟：优先使用Qt原生QKeyEvent方案，最简单高效。
• 全局模拟：根据目标平台选择对应原生API，均无需外部依赖和root权限（Wayland环境需特殊处理）。

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