C++控制台应用VS调试正常，直接启动时彩色文本不生效输出ANSI转义码

解答 #

核心原因 #

该问题的本质是Windows控制台默认未开启ANSI转义序列的解析能力。

• 对于Windows 10 1511及后续版本的系统，控制台本身已经兼容VT100/ANSI转义的输出规范，但该能力属于默认关闭的可选开关。当开关未打开时，控制台会把所有ANSI转义控制码当成普通文本直接打印，不会执行对应的颜色渲染逻辑，也就是直接启动时看到的“实际输出前直接打印转义码”的现象。
• 调试启动时功能正常，是因为Visual Studio在通过调试器启动控制台程序时，会自动为当前宿主控制台启用虚拟终端处理模式，相当于替程序打开了ANSI转义的解析开关，因此调试场景下彩色输出可以正常生效。
• 直接启动应用程序时，没有调试器的自动配置，控制台采用默认的未开启状态的配置，自然就无法正确解析ANSI转义序列。

解决方法 #

在程序初始化阶段，主动调用Windows控制台API手动开启虚拟终端处理模式，不需要依赖调试器的自动配置，即可让ANSI转义在直接启动时正常生效。
具体实现步骤：

• 调用GetStdHandle获取标准输出流的控制台句柄
• 调用GetConsoleMode读取当前控制台的配置模式
• 为读取到的模式添加ENABLE_VIRTUAL_TERMINAL_PROCESSING标志位
• 调用SetConsoleMode将修改后的模式重新设置给控制台

参考实现代码片段：

#include <windows.h>

void EnableConsoleAnsiSupport() {
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    if (hOut == INVALID_HANDLE_VALUE) return;
    DWORD dwMode = 0;
    if (!GetConsoleMode(hOut, &dwMode)) return;
    dwMode |= ENABLE_VIRTUAL_TERMINAL_PROCESSING;
    SetConsoleMode(hOut, dwMode);
}

注意：该方法仅支持Windows 10 1511及以上版本的系统。如果程序需要兼容更老的Windows系统，这些系统本身不原生支持ANSI转义序列，需要改用Win32控制台原生的SetConsoleTextAttributeAPI实现彩色输出。

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