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输出都会生效,直到下一次调用该函数或程序退出。
示例片段:
#include <windows.h>
#include <iostream>
int main() {
HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
SetConsoleTextAttribute(hOut, FOREGROUND_GREEN); // 绿字
std::cout
<h3>Linux/macOS用ANSI转义序列,但要确认终端支持</h3>
<p>Unix-like系统没有统一API,主流做法是输出ANSI转义序列(Escape Sequences),例如<code>\033[31m</code>表示红色字体。<code>\033</code>是ESC字符的八进制表示,后面接中括号和指令。</p>
<p>关键点不是“能不能写”,而是“终端是否解析”——某些老旧终端或IDE内置终端(如部分VS Code版本)默认禁用ANSI颜色,需手动开启或检查<code>TERM</code>环境变量是否为<code>xterm-256color</code>等支持颜色的类型。</p>
<p>常用代码值:</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master"><img
src="https://img.php.cn/upload/skill/000/000/081/179051228971575.jpg" alt="C++ Code Review Master" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="overflowclass">C++ Code Review Master</a>
<p class="overflowclass">组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。</p>
</div>
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>
<code>\033[30m</code>–<code>\033[37m</code>:标准8色前景(黑、红、绿、黄、蓝、紫、青、白)</li>
<li>
<code>\033[40m</code>–<code>\033[47m</code>:对应背景色</li>
<li>
<code>\033[0m</code>:重置所有样式(强烈建议每次输出后加这个,避免污染后续输出)</li>
</ul>
<p>示例:</p>
<pre class="brush:php;toolbar:false;">#include <iostream>
int main() {
std::cout
<h3>跨平台方案别硬写宏,优先用<code>fmt</code>或<code>colored</code>这类轻量库</h3>
<p>自己封装<code>#ifdef _WIN32</code>分支容易漏掉细节:比如Windows API调用失败时没检查返回值,或ANSI序列在Windows 10旧版cmd中默认关闭(需调用<code>SetConsoleMode</code>启用<code>ENABLE_VIRTUAL_TERMINAL_PROCESSING</code>)。</p>
<p>更省心的做法是引入成熟小库:</p>
<ul>
<li>
<code>fmt</code>(v10+)内置<code>fmt::print</code>支持<code>{:R}</code>、<code>{:G}</code>等颜色格式,自动适配平台</li>
<li>
<code>colored</code>(header-only)提供<code>colored::red("text")</code>这种链式调用,底层判断平台并选择API/ANSI</li>
</ul>
<p>例如用<code>fmt</code>:</p>
<pre class="brush:php;toolbar:false;">#include <fmt>
int main() {
fmt::print(fg(fmt::color::red), "这是红色\n");
fmt::print(fg(fmt::color::cyan) | bg(fmt::color::black), "青字黑底\n");
}</fmt>
它内部已处理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验证终端能力,再定位是代码问题还是环境问题。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










