如何在C++中实现类似Node.js process.stdin.on的终端按键捕获功能

C++ 标准库没有原生提供终端控制能力，我们可以通过操作系统提供的终端API实现和你给出的Node.js示例等价的功能，以下是POSIX平台（Linux、macOS、安卓等移动端系统）的实现方案，完美匹配你的需求：

核心思路 #

和Node.js的process.stdin.setRawMode(true)逻辑一致，我们需要：

1. 将终端从默认的行缓冲模式切换为原始（raw）模式，关闭输入回显、行缓冲、系统信号处理
2. 使用非阻塞IO监听标准输入，避免阻塞主线程
3. 解析输入的字节序列，识别普通按键、组合键、功能键

完整实现代码 #

#include <iostream>
#include <termios.h>
#include <unistd.h>
#include <poll.h>
#include <vector>

// 保存原始终端配置，程序退出前恢复
static termios g_original_termios;

// 开启终端raw模式
void enable_raw_mode() {
    tcgetattr(STDIN_FILENO, &g_original_termios);
    termios raw = g_original_termios;
    // 关闭回显、行缓冲、信号处理、特殊字节转换
    raw.c_lflag &= ~(ECHO | ICANON | ISIG | IEXTEN);
    raw.c_iflag &= ~(BRKINT | ICRNL | INPCK | ISTRIP | IXON);
    raw.c_cflag |= CS8;
    raw.c_cc[VMIN] = 0;
    raw.c_cc[VTIME] = 0;
    tcsetattr(STDIN_FILENO, TCSAFLUSH, &raw);
}

// 恢复终端默认模式
void disable_raw_mode() {
    tcsetattr(STDIN_FILENO, TCSAFLUSH, &g_original_termios);
}

// 非阻塞读取按键，返回空vector表示没有按键输入
std::vector<char> read_key_nonblock() {
    struct pollfd pfd = {STDIN_FILENO, POLLIN, 0};
    // 超时设为0，立即返回，完全不阻塞
    int ret = poll(&pfd, 1, 0);
    if (ret <= 0) return {};

    std::vector<char> buf(16);
    int n = read(STDIN_FILENO, buf.data(), buf.size());
    if (n > 0) buf.resize(n);
    else buf.clear();
    return buf;
}

int main() {
    // 程序退出自动恢复终端
    atexit(disable_raw_mode);
    enable_raw_mode();

    std::cout << "按任意键测试，按Ctrl+C退出" << std::endl;
    while (true) {
        auto key = read_key_nonblock();
        if (!key.empty()) {
            std::cout << "捕获到按键序列，长度：" << key.size() << "，字节值：";
            for (char c : key) {
                printf("0x%02x ", (unsigned char)c);
            }
            std::cout << std::endl;

            // 识别Ctrl+C退出
            if (key.size() == 1 && key[0] == 0x03) {
                break;
            }
        }

        // 这里可以放你的主线程其他逻辑
        usleep(1000); // 可选，降低CPU占用
    }
    return 0;
}

需求匹配说明 #

• 非阻塞主线程：read_key_nonblock函数使用poll监听输入，超时时间设为0，没有输入时立即返回空，你可以把它放到主循环的任意位置调用，不会卡住主线程其他逻辑。
• 适配软键盘：实现完全基于标准终端输入流，移动端的终端模拟器软键盘（比如安卓Termux、iOS的iSH）的输入都会走标准输入流，不需要额外适配即可正常工作。
• 全按键捕获：raw模式关闭了系统默认的信号处理，Ctrl+C、Ctrl+Z这类组合键不会触发系统信号，会直接返回对应的字节值；方向键、功能键、Alt/Shift修饰键的组合会以ESC开头的ANSI序列返回，你只需要按照ANSI标准解析序列即可识别所有按键。

Windows平台适配说明 #

如果需要兼容Windows系统，可以调用Win32 API实现相同逻辑：

• 用GetConsoleMode获取原始控制台配置
• 关闭ENABLE_LINE_INPUT、ENABLE_ECHO_INPUT、ENABLE_PROCESSED_INPUT三个开关，切换为raw模式
• 用WaitForSingleObject监听标准输入句柄实现非阻塞读取
• 用ReadConsoleInput读取输入事件，直接获取按键码、修饰键状态

内容的提问来源于stack exchange，提问作者Karel Matthieu L. Logro