在C语言编写Linux（Ubuntu）Shell时如何区分ESC序列与单独输入的ESC及后续字符？

这个问题我当初写自己的Linux Shell时也踩过坑，确实很头疼——毕竟ESC开头的输入太模棱两可了：既可能是用户按了单独的ESC键，也可能是方向键、功能键这类特殊键触发的多字节ESC序列。不过核心解决思路其实很直观：利用输入间隔的时间差来区分。

终端发送特殊键的ESC序列时，所有字节几乎是瞬时到达的（间隔远小于100毫秒）；而用户手动输入ESC+[+C这类字符，哪怕手速再快，字符之间的间隔也会远超这个阈值。基于这个差异，我们可以用超时机制来判断：

第一步：配置终端为非规范模式 #

默认情况下，Linux终端是“规范模式”——它会缓存输入直到用户按下换行才传给程序，这显然没法实时读取单个字节。所以我们需要先把终端改成非规范模式，同时关闭回显（避免输入的字符直接显示在屏幕上干扰判断），记得程序退出时要恢复终端设置，不然终端会陷入奇怪的状态。

示例代码片段：

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

struct termios orig_termios;

// 恢复终端原有属性
void reset_terminal() {
    tcsetattr(STDIN_FILENO, TCSANOW, &orig_termios);
}

// 设置终端为原始模式（非规范+无回显）
void set_raw_mode() {
    tcgetattr(STDIN_FILENO, &orig_termios);
    atexit(reset_terminal); // 程序退出时自动恢复终端

    struct termios raw = orig_termios;
    raw.c_lflag &= ~(ICANON | ECHO); // 关闭规范模式和回显
    raw.c_cc[VMIN] = 1; // 至少读取1个字节才返回
    raw.c_cc[VTIME] = 0; // 不设置超时
    tcsetattr(STDIN_FILENO, TCSANOW, &raw);
}

第二步：处理ESC开头的输入 #

当我们读到第一个字节是0x1b（ESC）时，就需要启动超时检测：

1. 临时修改终端的超时设置，比如设置100毫秒的超时（VTIME=1，单位是十分之一秒），同时把VMIN设为0（允许read()在超时后返回0，即没有读到后续字节）。
2. 在超时窗口内尝试读取后续字节：
   • 如果读到了后续字节，继续读取直到完整的ESC序列结束（比如常见的CSI序列是ESC [ 数字/; 字母，像右箭头就是ESC [ C）。
   • 如果超时后没有读到任何字节，就判定这是用户单独按下的ESC键。
3. 处理完后恢复终端的原始设置，避免影响后续输入。

核心处理逻辑的示例：

int main() {
    set_raw_mode();

    unsigned char buf[32];
    ssize_t n;

    while ((n = read(STDIN_FILENO, buf, sizeof(buf))) > 0) {
        for (ssize_t i = 0; i < n; i++) {
            if (buf[i] == 0x1b) {
                // 读到ESC，临时设置超时
                struct termios temp_termios;
                tcgetattr(STDIN_FILENO, &temp_termios);
                temp_termios.c_cc[VMIN] = 0; // 允许读取0个字节（超时返回）
                temp_termios.c_cc[VTIME] = 1; // 100毫秒超时
                tcsetattr(STDIN_FILENO, TCSANOW, &temp_termios);

                unsigned char seq[16];
                int seq_len = 1;
                seq[0] = 0x1b;

                // 尝试读取后续字节，直到序列完整或超时
                ssize_t seq_n;
                while ((seq_n = read(STDIN_FILENO, seq + seq_len, sizeof(seq) - seq_len)) > 0) {
                    seq_len += seq_n;
                    // 判断CSI序列是否结束：ESC [ 后跟字母（A-Z/a-z）
                    if (seq[1] == '[' && (seq[seq_len-1] >= 'A' && seq[seq_len-1] <= 'Z' || seq[seq_len-1] >= 'a' && seq[seq_len-1] <= 'z')) {
                        break;
                    }
                    // 可扩展支持其他类型的ESC序列，比如ESC O开头的序列
                }

                // 恢复终端原始设置
                tcsetattr(STDIN_FILENO, TCSANOW, &orig_termios);
                set_raw_mode(); // 重新设置为原始模式

                if (seq_len == 1) {
                    // 超时无后续字节，判定为单独ESC键
                    printf("检测到单独ESC键\n");
                } else {
                    // 判定为ESC序列，比如识别右箭头
                    if (seq_len == 3 && seq[1] == '[' && seq[2] == 'C') {
                        printf("检测到右箭头键\n");
                    } else {
                        printf("检测到ESC序列：");
                        for (int j = 0; j < seq_len; j++) {
                            printf("0x%02x ", seq[j]);
                        }
                        printf("\n");
                    }
                }
            } else {
                // 普通字符处理
                printf("检测到普通字符：%c (0x%02x)\n", buf[i], buf[i]);
            }
        }
    }

    return 0;
}

一些关键细节补充 #

1. 超时时间调整：示例中用了100毫秒（VTIME=1），你可以根据实际体验调整——如果经常误判用户手动输入为ESC序列，就把超时时间调长一点（比如VTIME=2即200毫秒）；如果觉得等待太久，就调短。
2. ESC序列的兼容性：不同终端的特殊键ESC序列可能略有差异（比如有些终端的F1键是ESC O P而不是ESC [ 11 ~）。如果想让程序适配更多终端，可以借助terminfo数据库，用tigetstr函数获取当前终端的特殊键序列（需要链接curses库，编译时加-lncurses）。
3. 终端属性恢复：一定要确保程序退出时恢复终端的原始属性，不然终端会处于无回显、不换行的状态，需要手动输入reset才能恢复。示例中用atexit注册了恢复函数，能覆盖大部分正常退出的场景。

内容来源于stack exchange