SetConsoleTextAttribute 是 Windows API 函数，用于设置控制台文字前景色、背景色和亮度，适用于 cmd/PowerShell 中的状态提示、菜单高亮等场景，需配合 GetStdHandle 获取句柄使用，不支持 Linux/macOS 及多数现代终端。

SetConsoleTextAttribute 是什么，能用在哪些地方 SetConsoleTextAttribute 是 Windows API 提供的函数，用于修改控制台（cmd 或 PowerShell）中文字的前景色、背景色和亮度。它只在 Windows 平台有效，Linux/macOS 不支持；也不适用于 VS Code 终端、Windows Terminal（新版）等现代终端——除非它们以兼容模式运行 cmd 子进程。 常见使用场景包括：命令行工具输出状态（如绿色 success、红色 error）、简易菜单高亮、调试信息分级着色。

注意：SetConsoleTextAttribute 必须搭配 GetStdHandle(STD_OUTPUT_HANDLE) 获取句柄才能生效，单独调用会失败。

word报告自动生成神器

Word报告自动生成神器。自动生成专业Word文档报告，支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。

下载

怎么正确调用 SetConsoleTextAttribute 调用前需包含头文件并链接库：

#include <windows.h>

关键步骤是获取标准输出句柄 + 设置属性值：

• HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE); —— 必须检查是否为 INVALID_HANDLE_VALUE
• 颜色值是位掩码组合，例如：FOREGROUND_GREEN | FOREGROUND_INTENSITY 表示亮绿色文字
• 背景色用 BACKGROUND_* 常量，但注意：默认控制台背景是黑色，设成其他色可能让文字不可读（比如白字+白背景）
• 每次调用只影响后续输出，不会重绘已有文字

简单示例（输出红字）：

SetConsoleTextAttribute(GetStdHandle(STD_OUTPUT_HANDLE), FOREGROUND_RED);
printf("This is red.\n");

常见错误和颜色值陷阱 容易踩的坑：

• 忘记恢复默认颜色，导致后续所有输出变色 —— 推荐保存原始属性：CONSOLE_SCREEN_BUFFER_INFO info; GetConsoleScreenBufferInfo(hOut, &info);，之后用 info.wAttributes 恢复
• 误用 BACKGROUND_RED 却没关掉 FOREGROUND_*，结果文字消失（比如红字+红背景）
• 在 MinGW 或某些 IDE 内置终端里调用失败，返回值为 0，GetLastError() 可能返回 ERROR_INVALID_HANDLE
• FOREGROUND_BLUE | FOREGROUND_GREEN 是青色，不是“蓝绿色混合出的新色”——它是按位或，不是 RGB 插值

可用颜色常量（仅 16 种基础组合）：

FOREGROUND_BLUE, FOREGROUND_GREEN, FOREGROUND_RED, FOREGROUND_INTENSITY

替代方案：跨平台怎么办 如果项目要兼容 Linux/macOS，SetConsoleTextAttribute 就不能用。此时可改用 ANSI 转义序列（现代终端基本都支持）：

printf("\033[31mRed text\033[0m\n"); // \033[0m 重置样式

Windows 10 1511+ 默认禁用 ANSI 支持，需手动启用：

SetConsoleOutputCP(CP_UTF8); // 可选
DWORD mode;
GetConsoleMode(hOut, &mode);
SetConsoleMode(hOut, mode | ENABLE_VIRTUAL_TERMINAL_PROCESSING);

但要注意：ANSI 方案在旧版 cmd.exe（Win7/Win8）下完全无效，而 SetConsoleTextAttribute 在这些系统上反而更可靠。 真正复杂的点在于——你得判断运行环境再决定走哪条路，而不是写死一个函数。