C语言开发中不依赖全功能封装库实现键盘输入的方法

scanf()是C标准库的行缓冲流输入函数，设计目标是读取格式化文本，完全不适合实时交互场景，无法实现多键同按、低延迟检测的需求。从零实现实时键盘输入的核心逻辑非常简单：直接调用操作系统原生输入接口，维护一个全局布尔数组存储每个按键的实时状态，收到按键按下事件时将对应数组成员置为true，收到抬起事件时置为false，主循环直接读取该数组即可获得任意时刻的按键状态，天然支持多键同时检测。
以下实现仅调用各平台系统自带的原生API，不引入任何全功能第三方依赖，代码可以直接集成到引擎中。 #

公共头文件定义 #

先创建通用头文件keyboard.h，定义对外暴露的接口和状态数组：

#ifndef KEYBOARD_H
#define KEYBOARD_H

#include <stdbool.h>
#include <stdint.h>

// 全局按键状态数组，索引为按键码，值为true表示按键处于按下状态
// 数组长度256足以覆盖全平台常规键盘的所有按键码范围
extern bool keys[256];

// 输入模块初始化，引擎启动时调用1次
void kb_init(void);
// 事件拉取，主循环每帧开头调用1次，刷新按键状态
void kb_poll(void);
// 资源释放，引擎退出时调用1次
void kb_shutdown(void);

#endif

分平台实现 #

Windows平台（Win32原生API，无额外依赖） #

Windows平台直接调用系统自带的user32库接口即可，不需要安装任何额外开发包：

// keyboard_win32.c
#include "keyboard.h"
#include <windows.h>
#include <string.h>

bool keys[256] = {0};

void kb_init(void) {
    memset(keys, 0, sizeof(keys));
}

void kb_poll(void) {
    // 遍历所有虚拟键码，直接读取按键物理状态
    for (uint16_t vk = 0; vk < 256; vk++) {
        SHORT state = GetAsyncKeyState(vk);
        // 返回值最高位为1表示按键当前按下
        keys[vk] = (state & 0x8000) != 0;
    }
}

void kb_shutdown(void) {
    // 无动态资源需要释放
}

编译时链接系统自带的user32库即可，MinGW编译加参数-luser32，MSVC默认会自动链接该库。如果需要仅在窗口聚焦时响应按键，可以把轮询逻辑替换为在窗口过程函数中处理WM_KEYDOWN/WM_KEYUP/WM_SYSKEYDOWN/WM_SYSKEYUP消息更新keys数组，避免捕获全局输入。

Linux平台（evdev原生接口，无桌面环境依赖） #

Linux平台直接读取内核暴露的evdev输入设备节点即可，不依赖X11/Wayland等桌面环境库，适配桌面、嵌入式等所有Linux运行场景：

// keyboard_linux.c
#include "keyboard.h"
#include <fcntl.h>
#include <unistd.h>
#include <linux/input.h>
#include <string.h>
#include <dirent.h>
#include <stdio.h>

bool keys[256] = {0};
static int dev_fds[64] = {0};
static int dev_count = 0;

static bool check_keyboard_dev(const char* dev_path) {
    int fd = open(dev_path, O_RDONLY | O_NONBLOCK);
    if (fd < 0) return false;
    
    // 校验设备是否支持按键输入
    unsigned long ev_bits[EV_MAX / (8 * sizeof(unsigned long)) + 1] = {0};
    if (ioctl(fd, EVIOCGBIT(0, sizeof(ev_bits)), ev_bits) < 0) {
        close(fd);
        return false;
    }
    if (!(ev_bits[EV_KEY / (8 * sizeof(unsigned long))] & (1UL << (EV_KEY % (8 * sizeof(unsigned long)))))) {
        close(fd);
        return false;
    }

    dev_fds[dev_count++] = fd;
    return true;
}

void kb_init(void) {
    memset(keys, 0, sizeof(keys));
    DIR* input_dir = opendir("/dev/input/by-id");
    if (!input_dir) input_dir = opendir("/dev/input");
    if (!input_dir) return;

    struct dirent* entry;
    while ((entry = readdir(input_dir)) != NULL) {
        if (strstr(entry->d_name, "event")) {
            char full_path[512] = {0};
            snprintf(full_path, sizeof(full_path), "/dev/input/%s", entry->d_name);
            check_keyboard_dev(full_path);
        }
    }
    closedir(input_dir);
}

void kb_poll(void) {
    struct input_event ev;
    for (int i = 0; i < dev_count; i++) {
        while (read(dev_fds[i], &ev, sizeof(ev)) == sizeof(ev)) {
            if (ev.type == EV_KEY && ev.code < 256) {
                if (ev.value == 1) keys[ev.code] = true;   // 按键按下
                if (ev.value == 0) keys[ev.code] = false;  // 按键抬起
                // ev.value == 2为系统长按自动重复事件，按需处理即可
            }
        }
    }
}

void kb_shutdown(void) {
    for (int i = 0; i < dev_count; i++) {
        close(dev_fds[i]);
    }
    dev_count = 0;
}

运行时需要当前用户拥有输入设备的读取权限，将用户加入input用户组即可，不需要安装任何第三方开发包。如果运行在X11/Wayland桌面环境下，也可以替换为通过X11/Wayland的窗口接口读取对应窗口的输入事件，避免捕获全局输入，核心状态更新逻辑完全一致。

使用方式 #

• 引擎初始化阶段调用一次kb_init()完成输入设备枚举
• 主逻辑循环每帧开头调用kb_poll()拉取最新输入事件，刷新按键状态数组
• 业务逻辑直接读取keys数组判断按键状态即可，可以自己封装一层跨平台键码宏统一键值：

// 跨平台键码映射示例
#ifdef _WIN32
#define KEY_W     0x57
#define KEY_A     0x41
#define KEY_S     0x53
#define KEY_D     0x44
#define KEY_SPACE VK_SPACE
#define KEY_ESC   VK_ESCAPE
#else
#include <linux/input-event-codes.h>
#define KEY_W     KEY_W
#define KEY_A     KEY_A
#define KEY_S     KEY_S
#define KEY_D     KEY_D
#define KEY_SPACE KEY_SPACE
#define KEY_ESC   KEY_ESC
#endif

// 游戏逻辑示例
if (keys[KEY_W]) {
    camera.pos.z -= move_speed * delta_time;
}
if (keys[KEY_SPACE]) {
    player.jump();
}

• 引擎退出时调用kb_shutdown()关闭打开的设备句柄，释放资源。

该实现总代码量不足300行，没有任何冗余依赖，按键状态检测延迟为系统输入原生延迟，支持任意数量按键同时按下的检测，完全满足3D引擎的实时输入需求。如果需要支持文本输入（比如聊天框、玩家ID输入），可以在现有事件处理逻辑上增加按键到字符的映射层即可，不需要修改核心状态检测逻辑。

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