实现无需聚焦终端的C语言全局键盘监听器的技术需求

你的现有代码依赖getchar()，只能读取当前终端的输入缓冲区内容，必须终端处于激活状态才能捕获按键。要实现全局监听，必须依赖目标操作系统的原生API——C标准库没有提供跨平台的全局输入捕获能力。以下分平台给出具体实现方案：

Linux 平台 #

方案1：直接读取输入设备文件 #

Linux下所有键盘输入会被写入/dev/input/event*设备文件，读取这些文件可捕获全局按键，需要root权限或将用户加入input组。

示例代码：

#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <unistd.h>
#include <linux/input.h>

// 替换为你的键盘设备，可用`ls /dev/input/`查看，配合`evtest`工具确认
#define KEYBOARD_DEVICE "/dev/input/event0"

int main() {
    int fd = open(KEYBOARD_DEVICE, O_RDONLY);
    if (fd == -1) {
        perror("Failed to open input device");
        exit(EXIT_FAILURE);
    }

    struct input_event ev;
    while (read(fd, &ev, sizeof(ev)) == sizeof(ev)) {
        // 仅处理按键按下事件
        if (ev.type == EV_KEY && ev.value == 1) {
            if (ev.code == KEY_Q) { // 监听Q键
                printf("Q key pressed, exiting...\n");
                close(fd);
                exit(EXIT_SUCCESS);
            }
            // 组合键示例：监听Ctrl+Q，需同时检测KEY_LEFTCTRL和KEY_Q的按下状态
        }
    }

    close(fd);
    return 0;
}

编译命令：gcc -o global_kb global_kb.c

方案2：X11 环境下的全局监听 #

如果运行在X窗口环境中，可使用X11 API实现监听，无需root权限：

#include <stdio.h>
#include <stdlib.h>
#include <X11/Xlib.h>
#include <X11/Xutil.h>

int main() {
    Display *dpy = XOpenDisplay(NULL);
    if (!dpy) {
        fprintf(stderr, "Cannot open display\n");
        exit(EXIT_FAILURE);
    }

    Window root = DefaultRootWindow(dpy);
    // 全局捕获键盘输入
    XGrabKeyboard(dpy, root, True, GrabModeAsync, GrabModeAsync, CurrentTime);

    XEvent ev;
    while (1) {
        XNextEvent(dpy, &ev);
        if (ev.type == KeyPress) {
            KeySym key = XLookupKeysym(&ev.xkey, 0);
            if (key == XK_q) { // 监听Q键
                printf("Q key pressed, exiting...\n");
                XUngrabKeyboard(dpy, CurrentTime);
                XCloseDisplay(dpy);
                exit(EXIT_SUCCESS);
            }
        }
    }

    XCloseDisplay(dpy);
    return 0;
}

编译命令：gcc -o x11_kb x11_kb.c -lX11

Windows 平台 #

通过设置全局键盘钩子捕获所有按键事件：

#include <stdio.h>
#include <windows.h>

HHOOK hKeyboardHook;

LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam) {
    if (nCode >= 0 && wParam == WM_KEYDOWN) {
        KBDLLHOOKSTRUCT *pKeyBoard = (KBDLLHOOKSTRUCT *)lParam;
        if (pKeyBoard->vkCode == 0x51) { // Q键的虚拟键码
            printf("Q key pressed, exiting...\n");
            PostQuitMessage(0);
        }
        // 组合键示例：监听Ctrl+Q
        // if (pKeyBoard->vkCode == 0x51 && (GetAsyncKeyState(VK_CONTROL) & 0x8000)) { ... }
    }
    return CallNextHookEx(hKeyboardHook, nCode, wParam, lParam);
}

int main() {
    hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardProc, GetModuleHandle(NULL), 0);
    if (!hKeyboardHook) {
        fprintf(stderr, "Failed to set hook\n");
        return 1;
    }

    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0) > 0) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    UnhookWindowsHookEx(hKeyboardHook);
    return 0;
}

编译命令（MSVC）：cl /EHsc global_kb.c user32.lib

macOS 平台 #

使用Quartz Event Services框架，程序需要获取辅助功能权限（系统偏好设置→安全性与隐私→隐私→辅助功能）：

#include <stdio.h>
#include <stdlib.h>
#include <ApplicationServices/ApplicationServices.h>

CGEventRef keyboardCallback(CGEventTapProxy proxy, CGEventType type, CGEventRef event, void *refcon) {
    if (type == kCGEventKeyDown) {
        CGKeyCode keyCode = CGEventGetIntegerValueField(event, kCGKeyboardEventKeycode);
        if (keyCode == 12) { // Q键的keyCode，不同键盘可能有差异
            printf("Q key pressed, exiting...\n");
            exit(EXIT_SUCCESS);
        }
        // 组合键示例：监听Command+Q
        // if (keyCode == 12 && (CGEventGetFlags(event) & kCGEventFlagMaskCommand)) { ... }
    }
    return event;
}

int main() {
    CFMachPortRef eventTap = CGEventTapCreate(
        kCGHIDEventTap,
        kCGHeadInsertEventTap,
        0,
        CGEventMaskBit(kCGEventKeyDown),
        keyboardCallback,
        NULL
    );

    if (!eventTap) {
        fprintf(stderr, "Failed to create event tap (check accessibility permissions)\n");
        exit(EXIT_FAILURE);
    }

    CFRunLoopSourceRef runLoopSource = CFMachPortCreateRunLoopSource(kCFAllocatorDefault, eventTap, 0);
    CFRunLoopAddSource(CFRunLoopGetCurrent(), runLoopSource, kCFRunLoopCommonModes);
    CGEventTapEnable(eventTap, true);

    CFRunLoopRun();

    CFRelease(runLoopSource);
    CFRelease(eventTap);
    return 0;
}

编译命令：gcc -o mac_kb mac_kb.c -framework ApplicationServices

注意事项 #

• 全局键盘监听通常需要特殊权限：Linux需root/input组权限、macOS需辅助功能权限、Windows部分场景需管理员权限。
• 组合键监听需同时检测多个按键的状态，比如Ctrl+Q要检查控制键与目标键的按下事件。
• 若需后台运行程序：Linux/macOS用nohup ./program &，Windows用start /B program.exe。

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