SetConsoleTextAttribute是Windows平台最直接、原生且稳定设置控制台颜色的方式，需先获取有效句柄并检查返回值，通过位运算组合前景色（低4位）与背景色（高4位）属性，影响后续所有输出，不支持RGB仅16种基础色，且须手动重置默认颜色。
Windows平台用SetConsoleTextAttribute最直接
在Windows控制台（cmd、PowerShell）中，SetConsoleTextAttribute是原生、稳定、无需第三方依赖的方式。它通过修改当前控制台句柄的文本属性来实现颜色切换，不依赖ANSI转义序列是否启用。
常见错误是直接调用后没检查返回值，或忽略句柄获取失败的情况——比如在VS调试器内置终端或某些远程终端里，GetStdHandle(STD_OUTPUT_HANDLE)可能返回INVALID_HANDLE_VALUE。
- 必须先用
GetStdHandle(STD_OUTPUT_HANDLE)获取句柄，且判断是否有效 - 颜色值是16进制组合：前景色（低4位）+ 背景色（高4位），例如
FOREGROUND_RED | FOREGROUND_INTENSITY表示亮红色文字 - 不支持RGB，只有16种基础色（含黑、白、灰阶），且背景色不能设为“亮”属性（
BACKGROUND_INTENSITY无效） - 每次调用只影响后续输出，不会自动恢复，建议封装成作用域类或手动重置为
FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE（白色）
跨平台用ANSI转义序列但要注意启用状态
Linux/macOS默认支持\033[31m这类ANSI序列，但Windows 10 1511+需显式启用虚拟终端处理，否则输出的是乱码或直接被忽略。
启用方式不是改注册表也不是装插件，而是调用SetConsoleMode并传入ENABLE_VIRTUAL_TERMINAL_PROCESSING标志——而且必须在首次输出前完成，晚了就无效。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 启用代码片段：
DWORD mode; GetConsoleMode(hOut, &mode); SetConsoleMode(hOut, mode | ENABLE_VIRTUAL_TERMINAL_PROCESSING); - 常用序列：
\033[32m（绿色文字）、\033[44;37m（蓝底白字）、\033[0m（重置所有样式） - 注意
\033是八进制转义，C++中写成"\033[32m"或"\x1b[32m"都行，但别用\e（非标准） - 某些IDE终端（如CLion旧版、Code::Blocks）不完全兼容ANSI，会显示方块或跳过颜色，此时回退到
SetConsoleTextAttribute更稳妥
std::cout流操作符封装颜色容易出缓冲问题
很多人想写std::cout 这种链式调用，但直接重载<code>operator对函数指针或仿函数时，容易触发流缓冲未刷新、颜色残留或跨线程干扰。
根本原因是std::ostream不保证每个操作后立即刷屏，尤其在重定向到文件或管道时，<code>\033[0m可能被缓存到下一行才输出，导致整页变色。
- 安全做法是把颜色开关和内容合并为一个
write_colored函数，内部强制调用os.flush()或用std::endl（它带flush） - 避免在lambda里捕获
std::cout并返回流引用——生命周期和线程安全性难控 - 如果用宏（如
#define RED "\033[31m"），记得加""拼接，别漏掉结尾的"\033[0m"，否则后续所有输出都被染色
Linux下g++编译无异常但运行无颜色？查TERM环境变量
即使代码用了ANSI序列，echo $TERM返回dumb或空值时，很多工具（如tmux、screen、CI环境中的bash）会主动屏蔽颜色输出，连ls --color都不生效。
这不是程序bug，而是终端声称自己“不支持颜色”，C++代码发了也白发。验证方法：在同环境下执行printf '\033[31mRED\033[0m\n'看是否真没反应。
- 临时修复：
export TERM=xterm-256color（推荐）或export TERM=screen-256color（tmux内） - 程序启动时可读取
getenv("TERM")，若匹配"dumb"、"unknown"等值，自动禁用颜色输出，避免污染日志 - 不要依赖
isatty(STDOUT_FILENO)判断——它只说明是终端，不保证支持ANSI；有些伪终端（如Docker exec）返回true但TERM=dumb
真正麻烦的从来不是怎么写颜色，而是怎么让颜色在不同终端、不同环境、不同重定向场景下行为一致。Windows上绕不开句柄和模式设置，Linux上逃不开TERM和缓冲控制，而跨平台抽象层（如fmt::print带color支持）往往在底层悄悄做了同样判断——只是你没看见而已。
