C++实现程序运行时临时清屏 退出后恢复终端原有状态

Linux/macOS 实现（无ncurses依赖） #

这类程序的"独立界面"效果本质是利用了终端的**交替屏幕缓冲区（Alternate Screen Buffer）**特性，现代xterm兼容终端（macOS Terminal、iTerm2、Gnome Terminal、Konsole等）都支持通过ANSI转义序列直接控制该特性，完全不需要依赖ncurses库，配合termios系统调用保存/还原终端状态即可实现。

核心实现步骤：

• 保存终端初始状态：程序启动时通过tcgetattr()读取当前tty的属性（包括行缓冲开关、输入回显开关等配置）存到全局变量，供退出时还原。
• 修改终端工作模式：关闭默认的规范行缓冲模式、输入回显，让程序可以直接接收按键输入、即时刷新界面，避免输入的字符直接打印到屏幕上。
• 切换到备用屏幕：向标准输出输出ANSI转义序列\x1b[?1049h，终端会自动切换到空白的备用屏幕，原有主屏幕的内容（包括之前的命令历史、输出）会被完整保留隐藏。
• 注册还原逻辑：通过atexit()注册正常退出的回调，同时注册SIGINT、SIGTERM、SIGHUP等常见终止信号的处理函数，保证程序无论正常退出还是被异常终止，都能执行还原逻辑：先输出转义序列\x1b[?1049l切回主屏幕，再通过tcsetattr()还原初始的终端属性。
• 所有转义序列输出后要调用fflush()或者用std::flush强制刷新输出流，避免行缓冲导致转义序列延迟发送。

最小可运行示例代码：

#include <iostream>
#include <termios.h>
#include <unistd.h>
#include <cstdlib>
#include <csignal>
#include <unistd.h>

static termios old_termios;
static int tty_fd;

// 统一终端还原逻辑
void restore_terminal() {
    // 切回主屏幕缓冲区
    std::cout << "\x1b[?1049l" << std::flush;
    // 还原原始终端属性
    tcsetattr(tty_fd, TCSANOW, &old_termios);
}

void signal_handler(int sig) {
    restore_terminal();
    std::_Exit(128 + sig);
}

int main() {
    tty_fd = STDIN_FILENO;
    // 非终端环境直接退出，避免乱码
    if (!isatty(tty_fd)) {
        std::cerr << "Not running in a terminal" << std::endl;
        return 1;
    }

    // 保存原始终端属性，关闭行缓冲、输入回显
    tcgetattr(tty_fd, &old_termios);
    termios new_termios = old_termios;
    new_termios.c_lflag &= ~(ICANON | ECHO);
    tcsetattr(tty_fd, TCSANOW, &new_termios);

    // 注册退出钩子和信号处理
    atexit(restore_terminal);
    signal(SIGINT, signal_handler);
    signal(SIGTERM, signal_handler);
    signal(SIGHUP, signal_handler);

    // 切换到备用屏幕
    std::cout << "\x1b[?1049h" << std::flush;

    // 自定义程序逻辑
    std::cout << "Alternate screen active, press any key to exit\r\n";
    char c;
    read(tty_fd, &c, 1);

    return 0;
}

编译时不需要链接额外库，直接执行g++ main.cpp -o alt_screen即可生成可执行文件，运行效果和sl、vim完全一致。

提示：如果需要兼容极老的非xterm兼容终端，可以读取TERM环境变量判断终端类型，选择对应的转义序列，日常使用场景下无需额外适配。

Windows 实现 #

Windows下有两种成熟实现方案，兼容从Win7到最新Win11的所有控制台环境：

• 原生Win32 API方案（兼容性最好）：通过系统控制台API创建独立的屏幕缓冲区，切换活动缓冲区实现界面隔离。核心流程是：启动时拿到当前主控制台缓冲区句柄保存，调用CreateConsoleScreenBuffer()创建新的文本模式缓冲区，通过SetConsoleActiveScreenBuffer()将新缓冲区设为活动状态即可。程序退出时切回原主缓冲区，关闭自建的缓冲区句柄即可完全还原之前的终端界面，同时要记得保存并还原控制台的输入输出模式（比如回显、快速编辑等配置），还要通过SetConsoleCtrlHandler()注册控制台事件回调，处理Ctrl+C、窗口关闭等异常退出场景。
• ANSI转义序列方案（Win10 1511及以上版本支持）：新版本Windows控制台已经支持VT转义序列，只需要先通过SetConsoleMode()打开输出句柄的ENABLE_VIRTUAL_TERMINAL_PROCESSING标志，后续就可以和Linux/macOS一样，通过输出\x1b[?1049h/\x1b[?1049l转义码切换备用/主屏幕，逻辑和Unix环境完全一致。

原生API最小可运行示例代码：

#include <windows.h>
#include <cstdlib>

static HANDLE hMainBuffer, hAltBuffer;
static DWORD old_input_mode;

// 统一控制台还原逻辑
void restore_console() {
    SetConsoleActiveScreenBuffer(hMainBuffer);
    SetConsoleMode(GetStdHandle(STD_INPUT_HANDLE), old_input_mode);
    CloseHandle(hAltBuffer);
}

BOOL WINAPI console_handler(DWORD sig) {
    if (sig == CTRL_C_EVENT || sig == CTRL_CLOSE_EVENT || sig == CTRL_SHUTDOWN_EVENT) {
        restore_console();
    }
    return FALSE;
}

int main() {
    hMainBuffer = GetStdHandle(STD_OUTPUT_HANDLE);
    HANDLE hInput = GetStdHandle(STD_INPUT_HANDLE);

    // 保存原有输入模式
    GetConsoleMode(hInput, &old_input_mode);
    DWORD new_input_mode = old_input_mode & ~(ENABLE_LINE_INPUT | ENABLE_ECHO_INPUT);
    SetConsoleMode(hInput, new_input_mode);

    // 创建并激活备用屏幕缓冲区
    hAltBuffer = CreateConsoleScreenBuffer(
        GENERIC_READ | GENERIC_WRITE,
        0,
        NULL,
        CONSOLE_TEXTMODE_BUFFER,
        NULL
    );
    SetConsoleActiveScreenBuffer(hAltBuffer);

    // 注册退出钩子和控制台事件处理
    atexit(restore_console);
    SetConsoleCtrlHandler(console_handler, TRUE);

    // 自定义程序逻辑
    DWORD written;
    WriteConsole(hAltBuffer, L"Alternate screen active, press any key to exit\r\n", 46, &written, NULL);
    WaitForSingleObject(hInput, INFINITE);

    return 0;
}

该代码可直接在MinGW、MSVC环境下编译，无需额外依赖。

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