Windows10下C++ Win32 GUI程序退出后控制台提示符覆盖日志文本问题

问题背景 #

操作系统为Windows10，应用程序以/SUBSYSTEM:WINDOWS链接，通过以下代码附加/分配控制台并重定向输入输出流：

void InitConsole()
{
    if (AttachConsole(ATTACH_PARENT_PROCESS) || AllocConsole()) {
        SetConsoleOutputCP(CP_UTF8);

        FILE* dummy;
        freopen_s(&dummy, "CONIN$", "r", stdin);
        freopen_s(&dummy, "CONOUT$", "w", stdout);
        freopen_s(&dummy, "CONOUT$", "w", stderr);

        DWORD consoleMode;
        GetConsoleMode(GetStdHandle(STD_OUTPUT_HANDLE), &consoleMode);
        consoleMode |= ENABLE_VIRTUAL_TERMINAL_PROCESSING;
        SetConsoleMode(GetStdHandle(STD_OUTPUT_HANDLE), consoleMode);

        std::ios::sync_with_stdio(true);

        std::wcout.clear();
        std::cout.clear();
        std::wcerr.clear();
        std::cerr.clear();
        std::wcin.clear();
        std::cin.clear();
    }
}

这段代码可正常显示带颜色的文本，但程序退出后，控制台提示符会覆盖已输出的日志文本，而非从日志末尾继续显示。该问题在Windows Terminal、PowerShell、命令提示符及VSCode集成终端中均会出现，且无论使用fmtlib、std::cout还是printf()输出日志，都存在相同问题。

预期效果为控制台提示符从日志文本末尾继续显示，该效果可通过使用/SUBSYSTEM:CONSOLE且不调用InitConsole()函数实现。

以下是最小复现代例（以/SUBSYSTEM:WINDOWS链接）：

#define UNICODE
#define _UNICODE
#include <iostream>
#include <windows.h>

int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PWSTR pCmdLine, int nCmdShow)
{
    if (AttachConsole(ATTACH_PARENT_PROCESS) || AllocConsole()) {
        SetConsoleOutputCP(CP_UTF8);

        FILE* dummy;
        freopen_s(&dummy, "CONIN$", "r", stdin);
        freopen_s(&dummy, "CONOUT$", "w", stdout);
        freopen_s(&dummy, "CONOUT$", "w", stderr);

        DWORD consoleMode;
        GetConsoleMode(GetStdHandle(STD_OUTPUT_HANDLE), &consoleMode);
        consoleMode |= ENABLE_VIRTUAL_TERMINAL_PROCESSING;
        SetConsoleMode(GetStdHandle(STD_OUTPUT_HANDLE), consoleMode);

        std::ios::sync_with_stdio(true);

        std::wcout.clear();
        std::cout.clear();
        std::wcerr.clear();
        std::cerr.clear();
        std::wcin.clear();
        std::cin.clear();
    }

    std::cout << "Test Text 1\n";
    std::cout << "Test Text 2\n";
    std::cout << "Test Text 3\n";

    FreeConsole();

    return 0;
}

解决方案 #

问题根源在于程序通过AttachConsole/AllocConsole关联控制台时，终端宿主无法正确追踪输出后的光标位置，导致程序退出（或调用FreeConsole）后，提示符回到错误位置覆盖日志。

可通过以下几种方式解决：

方法1：输出结束后添加换行并刷新缓冲区 #

在调用FreeConsole之前，确保输出一个换行符并刷新标准输出缓冲区，让终端明确光标应处于下一行开头：

修改复现代例中的输出部分：

std::cout << "Test Text 1\n";
    std::cout << "Test Text 2\n";
    std::cout << "Test Text 3\n";
    // 添加换行并自动刷新缓冲区
    std::cout << std::endl;

    FreeConsole();

也可以手动刷新缓冲区替代std::endl：

std::cout << "\n";
    std::cout.flush();

方法2：手动调整控制台光标位置 #

如果不想额外输出换行，可通过Windows API手动将光标移动到当前输出内容的下一行开头：

在FreeConsole前添加以下代码：

// 获取标准输出句柄
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    CONSOLE_SCREEN_BUFFER_INFO csbi;
    if (GetConsoleScreenBufferInfo(hOut, &csbi)) {
        // 将光标移动到下一行开头
        COORD newCursorPos = {0, csbi.dwCursorPosition.Y + 1};
        SetConsoleCursorPosition(hOut, newCursorPos);
    }

    FreeConsole();

方法3：避免调用FreeConsole（仅适用于AttachConsole场景） #

如果程序是附加到父进程控制台（而非自行分配控制台），可省略FreeConsole调用。父进程控制台会在子进程退出后自动维护正确的光标位置。但注意，如果是AllocConsole创建的独立控制台，不调用FreeConsole会导致控制台窗口残留。

验证 #

修改后重新编译运行，控制台提示符将从日志文本的末尾开始显示，与/SUBSYSTEM:CONSOLE的效果一致。

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