如何在X11的KeyPress/KeyRelease事件中获取不受布局与修饰键影响的虚拟键码

你遇到的问题很典型——XLookupString会把Shift、Alt这些修饰键和当前键盘布局的影响都算进去，而keycode又是和硬件扫描码绑定的，不同键盘布局里对应不同的物理按键，确实没法直接用。下面给你两种可行的解决方案，按需选择：

方法一：获取按键的基础（无修饰）KeySym #

这种方法适合你需要当前键盘布局下，按键上印的基础字符（比如德语键盘的1键，不管按不按Shift，都识别为1）。核心思路是跳过修饰键的影响，直接获取该按键在无任何修饰时的KeySym。

代码示例 #

#include <X11/Xlib.h>
#include <X11/Xkb.h>
#include <stdio.h>

int main() {
    Display *dpy = XOpenDisplay(NULL);
    if (!dpy) {
        fprintf(stderr, "Failed to open display\n");
        return 1;
    }

    XEvent ev;
    while (XNextEvent(dpy, &ev)) {
        if (ev.type == KeyPress || ev.type == KeyRelease) {
            XKeyEvent *key_ev = (XKeyEvent*)&ev;
            // 获取默认组、无修饰层级的KeySym（完全忽略Shift/Alt等）
            KeySym base_keysym = XkbKeycodeToKeysym(dpy, key_ev->keycode, 0, 0);

            // 判断是否是我们需要的0-9或A-Z
            if ((base_keysym >= XK_0 && base_keysym <= XK_9) || 
                (base_keysym >= XK_A && base_keysym <= XK_Z)) {
                printf("Physical key %c %s\n", 
                       (char)base_keysym, 
                       ev.type == KeyPress ? "pressed" : "released");
            }
        }
    }

    XCloseDisplay(dpy);
    return 0;
}

为什么这能行？ #

XkbKeycodeToKeysym允许你指定键盘组（0是默认布局组）和修饰层级（0代表无任何修饰键的状态），直接拿到该物理按键在当前布局下的基础映射——也就是按键上印的那个字符，完全不受Shift、Alt等修饰键的干扰。

编译时记得链接X11库：gcc your_code.c -o key_detector -lX11

方法二：基于物理按键位置识别（完全脱离布局） #

如果你需要完全不管当前键盘布局，只根据按键的物理位置来识别（比如不管布局是德语还是法语，物理上位于美式QWERTY键盘1键位置的按键，都识别为1），可以用Xkb的按键名称（Key Name）来判断。

代码示例 #

#include <X11/Xlib.h>
#include <X11/Xkb.h>
#include <stdio.h>
#include <string.h>

char get_physical_key(const char* key_name) {
    // 映射Xkb按键名称到物理按键字符（基于美式QWERTY布局）
    if (!strcmp(key_name, "AE01")) return '1';
    if (!strcmp(key_name, "AE02")) return '2';
    if (!strcmp(key_name, "AE03")) return '3';
    if (!strcmp(key_name, "AE04")) return '4';
    if (!strcmp(key_name, "AE05")) return '5';
    if (!strcmp(key_name, "AE06")) return '6';
    if (!strcmp(key_name, "AE07")) return '7';
    if (!strcmp(key_name, "AE08")) return '8';
    if (!strcmp(key_name, "AE09")) return '9';
    if (!strcmp(key_name, "AE10")) return '0';
    if (!strcmp(key_name, "AD01")) return 'A';
    if (!strcmp(key_name, "AD02")) return 'S';
    if (!strcmp(key_name, "AD03")) return 'D';
    if (!strcmp(key_name, "AD04")) return 'F';
    if (!strcmp(key_name, "AD05")) return 'G';
    if (!strcmp(key_name, "AD06")) return 'H';
    if (!strcmp(key_name, "AD07")) return 'J';
    if (!strcmp(key_name, "AD08")) return 'K';
    if (!strcmp(key_name, "AD09")) return 'L';
    if (!strcmp(key_name, "AC01")) return 'Z';
    if (!strcmp(key_name, "AC02")) return 'X';
    if (!strcmp(key_name, "AC03")) return 'C';
    if (!strcmp(key_name, "AC04")) return 'V';
    if (!strcmp(key_name, "AC05")) return 'B';
    if (!strcmp(key_name, "AC06")) return 'N';
    if (!strcmp(key_name, "AC07")) return 'M';
    // 可以继续添加其他需要的按键名称映射
    return 0;
}

int main() {
    Display *dpy = XOpenDisplay(NULL);
    if (!dpy) {
        fprintf(stderr, "Failed to open display\n");
        return 1;
    }

    // 获取Xkb键盘映射信息
    XkbDescPtr xkb_desc = XkbGetMap(dpy, XkbAllComponentsMask, XkbUseCoreKbd);
    if (!xkb_desc) {
        fprintf(stderr, "Failed to get Xkb map\n");
        XCloseDisplay(dpy);
        return 1;
    }

    XEvent ev;
    while (XNextEvent(dpy, &ev)) {
        if (ev.type == KeyPress || ev.type == KeyRelease) {
            XKeyEvent *key_ev = (XKeyEvent*)&ev;
            char key_name[XkbKeyNameLength + 1];
            XkbGetKeyName(xkb_desc, key_ev->keycode, key_name);
            key_name[XkbKeyNameLength] = '\0'; // 确保字符串结束

            char physical_key = get_physical_key(key_name);
            if (physical_key != 0) {
                printf("Physical key %c %s\n", 
                       physical_key, 
                       ev.type == KeyPress ? "pressed" : "released");
            }
        }
    }

    XkbFreeMap(xkb_desc, XkbAllComponentsMask, True);
    XCloseDisplay(dpy);
    return 0;
}

为什么这能行？ #

Xkb给每个物理按键分配了固定的名称（比如AE01对应美式QWERTY的1键位置，AD01对应A键位置），这个名称和当前键盘布局无关——不管你用德语、法语还是其他布局，物理位置相同的按键，Key Name都是一样的。通过映射这些名称，就能完全脱离布局识别物理按键。

编译时链接X11库：gcc your_code.c -o key_detector -lX11

总结 #

• 如果你的需求是当前布局下按键的基础字符（比如德语键盘的1键识别为1），用方法一即可，代码更简洁。
• 如果需要完全不管布局，只看物理位置，用方法二。

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