SetConsoleTextAttribute是Windows平台最直接的控制台颜色设置函数,需配合GetStdHandle获取句柄及按位或组合FOREGROUND_/BACKGROUND_常量,影响后续所有输出直至再次调用。

Windows平台用SetConsoleTextAttribute改颜色最直接
在Windows命令行(cmd、PowerShell)中,C++程序可以通过Windows API的SetConsoleTextAttribute函数实时修改后续输出的字体和背景色。它需要一个句柄(通常用GetStdHandle(STD_OUTPUT_HANDLE)获取)和一个16进制属性值(前景色+背景色组合)。
常见颜色常量定义在windows.h里:FOREGROUND_RED、BACKGROUND_GREEN等。组合时用按位或(|),比如红字白底是FOREGROUND_RED | BACKGROUND_RED | BACKGROUND_GREEN | BACKGROUND_BLUE(白=RGB全开)。
注意:这个函数只影响当前控制台窗口,且不跨进程;调用后所有std::cout、printf输出都会生效,直到下一次调用该函数或程序退出。
示例片段:
立即学习“C++免费学习笔记(深入)”;
#include <windows.h>
#include <iostream>
int main() {
HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
SetConsoleTextAttribute(hOut, FOREGROUND_GREEN); // 绿字
std::cout << "这行是绿色的\n";
SetConsoleTextAttribute(hOut, FOREGROUND_RED | BACKGROUND_YELLOW); // 红字黄底
std::cout << "这行是红字黄底\n";
return 0;
}
Linux/macOS用ANSI转义序列,但要确认终端支持
Unix-like系统没有统一API,主流做法是输出ANSI转义序列(Escape Sequences),例如\033[31m表示红色字体。\033是ESC字符的八进制表示,后面接中括号和指令。
关键点不是“能不能写”,而是“终端是否解析”——某些老旧终端或IDE内置终端(如部分VS Code版本)默认禁用ANSI颜色,需手动开启或检查TERM环境变量是否为xterm-256color等支持颜色的类型。
常用代码值:
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
\033[30m–\033[37m:标准8色前景(黑、红、绿、黄、蓝、紫、青、白) -
\033[40m–\033[47m:对应背景色 -
\033[0m:重置所有样式(强烈建议每次输出后加这个,避免污染后续输出)
示例:
#include <iostream>
int main() {
std::cout << "\033[32m绿色文字\033[0m\n";
std::cout << "\033[1;33m加粗黄色\033[0m\n"; // 1=加粗,33=黄色前景
return 0;
}
跨平台方案别硬写宏,优先用fmt或colored这类轻量库
自己封装#ifdef _WIN32分支容易漏掉细节:比如Windows API调用失败时没检查返回值,或ANSI序列在Windows 10旧版cmd中默认关闭(需调用SetConsoleMode启用ENABLE_VIRTUAL_TERMINAL_PROCESSING)。
更省心的做法是引入成熟小库:
-
fmt(v10+)内置fmt::print支持{:R}、{:G}等颜色格式,自动适配平台 -
colored(header-only)提供colored::red("text")这种链式调用,底层判断平台并选择API/ANSI
例如用fmt:
#include <fmt/color.h>
int main() {
fmt::print(fg(fmt::color::red), "这是红色\n");
fmt::print(fg(fmt::color::cyan) | bg(fmt::color::black), "青字黑底\n");
}
它内部已处理Windows控制台模式初始化,比手写SetConsoleMode更可靠。
别忽略控制台本身限制:颜色可能被覆盖或失效
即使代码逻辑正确,输出颜色仍可能消失,常见原因有:
- 程序运行在不支持颜色的环境里(如CI日志管道、重定向到文件、某些远程SSH终端)
- IDE终端模拟器未启用颜色支持(如CLion默认关闭ANSI,需在Settings → Tools → Terminal勾选“Override IDE font”并确认编码)
- Windows旧版cmd(Win7及更早)不支持ANSI,也不支持
SetConsoleTextAttribute以外的颜色方式;而新Windows Terminal默认支持ANSI,但传统cmd需手动启用虚拟终端 - 使用
std::endl或\n后未重置样式,导致后续第三方库输出也被染色(尤其多线程下更难排查)
调试时可先用echo -e "\033[31mTEST\033[0m"(Linux/macOS)或PowerShell中Write-Host "TEST" -ForegroundColor Red验证终端能力,再定位是代码问题还是环境问题。

















