如何使用ANSI转义序列获取终端尺寸？

架构老林

2026-8-12

使用ANSI转义码获取终端尺寸的实现细节

我研究获取终端尺寸的方法时，注意到可以用ANSI转义码实现，相比ioctl()或getenv()，这种方式更优雅。

看到过一种降级方案的思路：先尝试TIOCWINSZ ioctl，非终端环境下用getenv("COLUMNS")，最后 fallback 到ANSI方法——把光标移到右下角再查询位置，这种方法在嵌入式串口控制台也能生效。

我查了相关资料，已经搞懂第一步：用CUP命令（\x1b[9999;9999H）把光标移到终端的最右下角，这部分很简单。但卡在了第二步：虽然知道要用DSR命令（\x1b[6n）查询设备状态，但不清楚这个查询的具体工作机制——怎么把返回的数据存到变量里，还不能干扰终端上的其他内容？

具体实现步骤

要解决这个问题，核心是临时修改终端的输入输出模式，避免查询过程干扰终端显示，步骤如下：

1. 保存并修改终端属性

首先用tcgetattr()获取当前终端的属性并保存，然后修改属性：

关闭回显（ECHO位清零），避免返回的ANSI序列显示在终端上
设置非规范模式（ICANON位清零），这样可以立即读取输入，不用等待换行符
关闭信号响应（ISIG位清零），避免Ctrl+C这类信号打断流程

2. 发送ANSI命令并读取返回值

发送\x1b[9999;9999H：终端会自动把光标定位到实际的右下角（即终端的真实行数、列数位置）
发送\x1b[6n：终端会返回类似\x1b[<行>;<列>R的字符串
读取并解析这个返回字符串，提取出的行、列数值就是终端的高度和宽度

3. 恢复终端属性

读取完数据后，必须用tcsetattr()恢复之前保存的终端属性，否则终端会处于异常状态（比如输入不回显）

C语言示例代码

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

typedef struct {
    int rows;
    int cols;
} TerminalSize;

TerminalSize get_terminal_size_ansi() {
    TerminalSize size = {0, 0};
    struct termios orig_attr, temp_attr;

    // 保存原终端属性
    if (tcgetattr(STDIN_FILENO, &orig_attr) != 0) {
        return size;
    }

    // 设置临时终端属性：非规范模式+关闭回显+关闭信号
    temp_attr = orig_attr;
    temp_attr.c_lflag &= ~(ICANON | ECHO | ISIG);
    temp_attr.c_cc[VMIN] = 1;  // 至少读取1个字符
    temp_attr.c_cc[VTIME] = 0; // 无超时限制

    if (tcsetattr(STDIN_FILENO, TCSANOW, &temp_attr) != 0) {
        tcsetattr(STDIN_FILENO, TCSANOW, &orig_attr);
        return size;
    }

    // 先保存当前光标位置（可选，用于后续恢复）
    printf("\x1b[s");
    fflush(stdout);

    // 发送光标移动命令到右下角
    printf("\x1b[9999;9999H");
    fflush(stdout);

    // 发送设备状态查询命令
    printf("\x1b[6n");
    fflush(stdout);

    // 读取返回的ANSI序列
    char buf[32];
    int i = 0;
    while (i < sizeof(buf)-1) {
        if (read(STDIN_FILENO, &buf[i], 1) != 1) break;
        if (buf[i] == 'R') break;
        i++;
    }
    buf[i] = '\0';

    // 解析行和列数值
    if (sscanf(buf, "\x1b[%d;%d", &size.rows, &size.cols) != 2) {
        size.rows = 0;
        size.cols = 0;
    }

    // 恢复原终端属性
    tcsetattr(STDIN_FILENO, TCSANOW, &orig_attr);

    // 恢复光标到之前的位置
    printf("\x1b[u");
    fflush(stdout);

    return size;
}

int main() {
    TerminalSize size = get_terminal_size_ansi();
    if (size.rows > 0 && size.cols > 0) {
        printf("终端尺寸：%d行 × %d列\n", size.rows, size.cols);
    } else {
        printf("无法获取终端尺寸\n");
    }
    return 0;
}

关键细节说明

终端模式切换：这是实现的核心，必须临时修改终端属性，否则read()会等待回车，且返回的ANSI序列会直接显示在终端上
fflush(stdout)：标准输出默认是行缓冲，发送ANSI命令后必须手动刷新，确保命令立即发送到终端
光标恢复：用\x1b[s保存光标位置、\x1b[u恢复位置，避免光标停在右下角影响用户体验
兼容性：大部分ANSI兼容终端（包括嵌入式串口控制台）都支持这些命令，但如果终端不兼容，该方法会失效，建议搭配ioctl()、getenv()做降级处理

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