Linux/X11环境下将输入事件码映射为当前键盘布局对应按键的咨询

你可以直接使用X11自带的XKB（X Keyboard Extension）标准接口实现需求，完全不需要硬编码键盘布局映射表，自动适配所有用户的本地布局配置。 #

核心逻辑 #

Linux input event code本质是键盘硬件扫描码，X11会通过XKB组件基于当前用户的键盘布局配置，自动完成扫描码到实际字符的映射，你只需要调用官方接口完成转换即可。

具体实现步骤 #

• 依赖安装：开发时链接X11和XKB相关库即可，C/C++编译时添加-lX11 -lXkbcommon -lXkbcommon-X11参数，其他语言（Python/Go等）都有对应XKB绑定包可以直接使用。
• 扫描码转X11键码：X11键码和Linux input event code有固定偏移，公式为x11_keycode = linux_input_event_code + 8，不需要额外配置。
• 键码转实际字符：调用XKB提供的字符转换接口，传入当前键盘状态（修饰键按下状态等），就能直接得到对应布局下的实际字符。

示例代码（C语言） #

#include <X11/Xlib.h>
#include <xkbcommon/xkbcommon.h>
#include <xkbcommon/xkbcommon-x11.h>

// 初始化XKB上下文（全局初始化一次即可）
struct xkb_context* init_xkb_ctx(Display *dpy) {
    struct xkb_context *ctx = xkb_context_new(XKB_CONTEXT_NO_FLAGS);
    int32_t keyb_dev_id = xkb_x11_get_core_keyboard_device_id(dpy);
    struct xkb_keymap *keymap = xkb_x11_keymap_new_from_device(ctx, dpy, keyb_dev_id, XKB_KEYMAP_COMPILE_NO_FLAGS);
    struct xkb_state *state = xkb_state_new(keymap);
    // 这里可以把state存在全局变量里复用
    return ctx;
}

// 输入event code和修饰键状态，输出对应字符
const char* code_to_char(uint16_t input_code, uint32_t mod_mask, struct xkb_state *state) {
    xkb_keycode_t x11_keycode = input_code + 8;
    // 更新修饰键状态（Ctrl/Shift/Alt等）
    xkb_state_update_mask(state, mod_mask, 0, 0, 0, 0, 0);
    static char buf[32];
    int str_len = xkb_state_key_get_utf8(state, x11_keycode, buf, sizeof(buf));
    if (str_len > 0) {
        return buf;
    }
    // 非可打印字符可以取键名做特殊处理
    xkb_keysym_t sym = xkb_state_key_get_one_sym(state, x11_keycode);
    return xkb_keysym_get_name(sym);
}

组合键处理 #

对于Ctrl+C这类带修饰键的快捷键，只需要把修饰键对应的掩码（比如Ctrl对应XKB_MOD_CONTROL）传入xkb_state_update_mask接口，就能正确识别组合键的含义，不需要手动解析修饰键的event code。

框架适配 #

如果你用Qt、GTK等GUI框架开发，框架已经封装了对应的键盘布局映射接口，直接调用即可，底层同样是走XKB系统配置，适配所有布局。

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