Linux下C++开发TUI游戏如何实现类似GetKeyState的按键检测

针对开发TUI游戏需要实时获取4个功能按键状态的需求，以下是可直接落地的Linux平台实现方案，逻辑对齐Windows下GetKeyState()的能力：

方案1：ncurses库实现（首推，适配成本最低） #

ncurses是Linux平台开发TUI程序的标准库，原生支持非阻塞按键读取、终端渲染能力，不需要额外适配不同终端的输入差异，最适合快速开发游戏。

• 编译时需要链接ncurses库，编译参数追加-lncurses即可
• 核心实现代码参考：

#include <ncurses.h>

int main() {
    // 初始化ncurses环境
    initscr();
    cbreak(); // 关闭行缓冲，按键按下立即触发，不需要等待回车
    noecho(); // 关闭按键自动回显，避免输入字符打乱游戏画面
    nodelay(stdscr, TRUE); // 开启非阻塞模式，无按键输入时读取函数直接返回，不会卡住游戏帧循环
    keypad(stdscr, TRUE); // 开启特殊按键识别，支持方向键、Shift等功能键读取

    int key;
    while (/* 你的游戏运行判断条件 */) {
        key = getch();
        switch (key) {
            case KEY_LEFT:
                // 执行玩家左移逻辑
                break;
            case KEY_RIGHT:
                // 执行玩家右移逻辑
                break;
            case KEY_UP:
                // 执行垂直方向加速逻辑
                break;
            case KEY_SLEFT:
                // 执行水平冲刺逻辑（绑定左Shift，可自行替换为其他按键）
                break;
            case ERR:
                // 无按键按下时，执行默认帧逻辑
                break;
        }
        // 插入游戏状态更新、画面渲染逻辑
        napms(16); // 控制帧间隔约为60FPS
    }

    endwin(); // 游戏退出前必须恢复终端默认状态，避免终端显示异常
    return 0;
}

如果需要实时判断按键长按状态，可以通过维护一个按键状态数组，在检测到按键按下/抬起事件时更新对应状态位，和Windows下GetKeyState()的调用逻辑完全一致。

方案2：读取内核输入设备节点（低延迟，适合高实时性场景） #

如果需要最低的输入延迟、精准获取按键按下/抬起的全状态，可以直接读取Linux内核暴露的输入设备节点，拿到原始键盘事件，不受终端输入规则限制。

• 注意事项：运行程序需要当前用户有输入设备读取权限，可通过sudo运行，或者将当前用户加入input用户组
• 核心实现代码参考：

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

int main() {
    // 键盘设备节点一般为/dev/input/eventX，可通过查看/proc/bus/input/devices里键盘对应的handler值确定
    int kbd_fd = open("/dev/input/event2", O_RDONLY | O_NONBLOCK);
    struct input_event ev;

    while (/* 游戏运行判断条件 */) {
        // 批量读取当前帧所有输入事件
        while (read(kbd_fd, &ev, sizeof(ev)) == sizeof(ev)) {
            if (ev.type == EV_KEY) {
                // ev.value对应按键状态：1=按下，0=抬起，2=长按触发
                switch (ev.code) {
                    case KEY_LEFT:
                        // 更新左移状态：ev.value为1/2时处于左移状态，0时停止
                        break;
                    case KEY_RIGHT:
                        // 更新右移状态
                        break;
                    case KEY_LEFTSHIFT:
                        // 更新冲刺状态
                        break;
                    case KEY_UP:
                        // 更新垂直加速状态
                        break;
                }
            }
        }
        // 插入游戏状态更新、画面渲染逻辑
        usleep(16000); // 约60FPS帧间隔
    }

    close(kbd_fd);
    return 0;
}

方案3：termios修改终端属性（轻量无第三方依赖） #

如果不想引入第三方库，也不想申请设备读取权限，可以直接用Linux原生termios接口修改终端输入模式，关闭行缓冲和回显，实现非阻塞按键读取，本质是手动实现ncurses的输入层逻辑。

• 核心终端配置代码参考：

#include <termios.h>
#include <unistd.h>
#include <fcntl.h>
#include <stdlib.h>

struct termios orig_term_conf;

// 退出时恢复终端默认配置，避免终端显示异常
void restore_terminal() {
    tcsetattr(STDIN_FILENO, TCSAFLUSH, &orig_term_conf);
}

void init_raw_terminal() {
    tcgetattr(STDIN_FILENO, &orig_term_conf);
    atexit(restore_terminal);
    struct termios raw_conf = orig_term_conf;
    // 关闭行缓冲、按键回显、信号触发
    raw_conf.c_lflag &= ~(ECHO | ICANON | ISIG);
    // 开启标准输入非阻塞读取
    fcntl(STDIN_FILENO, F_SETFL, O_NONBLOCK);
    tcsetattr(STDIN_FILENO, TCSAFLUSH, &raw_conf);
}

初始化完成后直接read()标准输入即可拿到按键对应的字节序列，自行解析对应按键的转义码即可，缺点是不同终端模拟器的功能键转义序列存在差异，适配成本较高。

选型建议 #

• 优先选ncurses方案，自带TUI渲染、颜色输出、光标控制等能力，能覆盖做TUI游戏的绝大多数需求，适配成本最低
• 如果做强操作反馈的动作类游戏，对输入延迟要求极高，选读取输入设备节点的方案
• 如果需要打包为单文件无依赖的小程序，选termios自实现方案

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