Windows 控制台雙緩衝技術消除閃爍：原理與核心 API 實現指南

為什麼需要雙緩衝？

控制台遊戲/動畫頻繁 `printf` 刷新畫面時，用戶會看到逐幀繪製的過程（先出現局部、再補全），產生嚴重閃爍。雙緩衝將「繪製過程」放到非可見緩衝區，一次性切換顯示，實現無閃爍幀率。

核心原理

1. 系統預設有一個活動屏幕緩衝區（用戶可見）
2. 調用 `CreateConsoleScreenBuffer` 創建第二個緩衝區（非可見）
3. 在後台緩衝區 `WriteConsole` 寫入完整幀內容
4. 調用 `SetConsoleActiveScreenBuffer` 切換為活動緩衝區
5. 循環：交替使用兩個緩衝區，實現無縫動畫

關鍵 Windows API

API	作用	關鍵參數
CreateConsoleScreenBuffer	創建新緩衝區	`GENERIC_READ | GENERIC_WRITE`, `CONSOLE_TEXTMODE_BUFFER`
SetConsoleActiveScreenBuffer	切換活動緩衝區	緩衝區句柄
WriteConsole	向指定緩衝區寫字符	句柄、字符串、長度、寫入字符數指針
SetConsoleCursorInfo	隱藏/顯示光標	`bVisible = FALSE` 消除光標閃爍
SetConsoleCursorPosition	定位光標	`COORD {0,0}` 歸零

最小可行雙緩衝框架

#include <windows.h>
#include <stdio.h>

int main() {
    // 1. 創建兩個緩衝區
    HANDLE hBuffer[2];
    hBuffer[0] = CreateConsoleScreenBuffer(GENERIC_READ | GENERIC_WRITE,
                                           0, NULL, CONSOLE_TEXTMODE_BUFFER, NULL);
    hBuffer[1] = CreateConsoleScreenBuffer(GENERIC_READ | GENERIC_WRITE,
                                           0, NULL, CONSOLE_TEXTMODE_BUFFER, NULL);
    if (hBuffer[0] == INVALID_HANDLE_VALUE || hBuffer[1] == INVALID_HANDLE_VALUE) return 1;

    // 2. 隱藏光標
    CONSOLE_CURSOR_INFO cci = {1, FALSE};
    SetConsoleCursorInfo(hBuffer[0], &cci);
    SetConsoleCursorInfo(hBuffer[1], &cci);

    int front = 0;  // 當前顯示緩衝區索引
    COORD pos = {0, 0};
    char frame[80 * 25 + 1];  // 假設 80x25 控制台

    while (1) {
        HANDLE back = hBuffer[1 - front];  // 後台緩衝區

        // 3. 構建幀內容（示例：移動的字符）
        static int x = 0, dir = 1;
        memset(frame, ' ', sizeof(frame) - 1);
        frame[x] = '*';
        frame[sizeof(frame) - 1] = '\0';
        x += dir;
        if (x == 79 || x == 0) dir = -dir;

        // 4. 寫入後台緩衝區
        DWORD written;
        SetConsoleCursorPosition(back, pos);
        WriteConsole(back, frame, strlen(frame), &written, NULL);

        // 5. 切換顯示
        SetConsoleActiveScreenBuffer(back);
        front = 1 - front;

        Sleep(50);  // 幀率控制 ~20 FPS
    }

    // 清理（實際需在退出循環時執行）
    CloseHandle(hBuffer[0]);
    CloseHandle(hBuffer[1]);
    return 0;
}

進階優化要點

1. 只更新變化區域：用 `FillConsoleOutputCharacter` / `WriteConsoleOutput` 批量寫入矩形區域
2. 字符屬性（顏色）：`WriteConsoleOutputAttribute` 設置前景/背景色
3. 輸入處理：另開線程 `ReadConsoleInput` 處理鍵盤，避免阻塞渲染
4. 高精度計時：`QueryPerformanceCounter` 替代 `Sleep` 實現固定幀率

對比：雙緩衝 vs 單緩衝 vs ANSI 轉義序列

| 方案 | 閃爍 | 複雜度 | 移植性 | 適用場景 | |------|------|--------|--------|----------| | 單緩衝 `printf` | 嚴重 | 低 | 跨平台 | 靜態輸出 | | **Win32 雙緩衝** | **無** | 中 | **僅 Windows** | **控制台遊戲、高頻動畫** | | ANSI `\033[H\033[2J` | 輕微 | 低 | 現代終端支援 | 跨平台簡易 TUI | | ncurses / PDCurses | 無 | 高 | 跨平台 | 複雜 TUI 應用 |

常見坑點

| 坑點 | 現象 | 修正 | |------|------|------| | 未隱藏光標 | 光標在字符間跳動 | `SetConsoleCursorInfo(..., FALSE)` | | 緩衝區尺寸不匹配 | 寫入截斷/換行錯亂 | `SetConsoleScreenBufferSize` 統一尺寸 | | 忘記 `CloseHandle` | 句柄洩漏 | 退出時成對關閉 | | `WriteConsole` 未檢查返回 | 靜默失敗 | 檢查 `written` 與預期長度 |

總結

Windows 控制台雙緩衝是平台特有但極其有效的無閃爍渲染技術。掌握「創建→寫後台→切換→循環」四步核心流程，配合光標隱藏、座標定位、屬性寫入，即可構建流暢的控制台遊戲/動畫引擎。跨平台項目建議抽象渲染層，Windows 用雙緩衝，Linux/macOS 用 ANSI/ncurses。