C#控制台应用程序默认使用当前终端的前景色和背景色输出文本，通常就是黑底白字。如果想突出某些提示信息、错误消息或成功状态，就需要通过System.Console类提供的属性来修改颜色。在.NET中，控制台颜色由Console.ForegroundColor和Console.BackgroundColor两个属性控制，它们接受ConsoleColor枚举值。最基本的设置方式如下：
using System;
class Program
{
static void Main()
{
Console.ForegroundColor = ConsoleColor.Green;
Console.WriteLine("这是绿色文本");
Console.ResetColor();
Console.WriteLine("恢复默认颜色");
}
}
一、控制台颜色的基本设置方法
Console.ForegroundColor设置文本颜色，Console.BackgroundColor设置背景色。两个属性都是可读写的，默认值分别为ConsoleColor.Gray和ConsoleColor.Black。赋值后，后续所有通过Console.Write或Console.WriteLine输出的文本都会使用新颜色，直到再次修改或调用ResetColor方法。ResetColor会将前景色和背景色恢复为默认值，并清除所有颜色效果。
ConsoleColor枚举包含16种颜色：Black、DarkBlue、DarkGreen、DarkCyan、DarkRed、DarkMagenta、DarkYellow、Gray、DarkGray、Blue、Green、Cyan、Red、Magenta、Yellow、White。这些颜色在Windows控制台和常见终端中都能被正确识别。如果需要更丰富的颜色，可以借助ANSI转义序列，但本文先聚焦于Console类提供的标准方法。
下面给出一个更完整的例子，演示如何同时设置前景色和背景色，并在不同消息类型间切换：
using System;
class ColorDemo
{
static void Main()
{
// 设置红色背景、白色文字
Console.BackgroundColor = ConsoleColor.Red;
Console.ForegroundColor = ConsoleColor.White;
Console.WriteLine("错误：连接失败");
// 恢复默认
Console.ResetColor();
// 设置黄色前景，输出警告
Console.ForegroundColor = ConsoleColor.Yellow;
Console.WriteLine("警告：磁盘空间不足");
Console.ResetColor();
}
}
需要特别注意的是，在Windows控制台中，修改BackgroundColor只会影响新写入的文本的背景区域，通常是一整行或一行中的字符背景，而不是整个控制台窗口。这与一些开发者预期的“整个窗口变色”不同。另外，如果只设置前景色而不设置背景色，文本的背景仍然是原来的颜色。
二、颜色设置失效的常见问题与排错
很多开发者在设置颜色后会发现输出没有任何变化，或颜色只持续了一瞬间。最常见的原因是在调用WriteLine之后紧接着调用了ResetColor，或者在循环中多次赋值但忘记在每次输出前重新设置。颜色属性是“状态性”的，一旦赋值就会一直保持，直到被改变或重置。如果代码中使用了日志框架或者第三方库，它们可能在内部调用了ResetColor，从而导致后续自己的输出颜色丢失。
另一个高频问题是输出重定向。当控制台输出被重定向到文件或管道时（例如使用>命令或在IDE的“输出”面板中查看），Console.ForegroundColor和Console.BackgroundColor的设置不会产生任何效果。可以使用Console.IsOutputRedirected属性检测输出是否被重定向，从而决定是否应用颜色。示例：
using System;
class RedirectCheck
{
static void Main()
{
if (Console.IsOutputRedirected)
{
Console.WriteLine("输出被重定向，颜色设置无效");
}
else
{
Console.ForegroundColor = ConsoleColor.Cyan;
Console.WriteLine("正常终端显示青色文本");
Console.ResetColor();
}
}
}
此外，在Visual Studio的调试输出窗口中运行控制台程序时，颜色显示也可能异常。这是因为Visual Studio宿主进程并非标准的Windows控制台，某些版本对Console颜色支持不完整。如果希望测试颜色效果，建议直接使用cmd或Windows Terminal运行生成的exe文件，而不是依赖IDE的调试窗口。
跨平台环境也需要注意。在Linux和macOS上，.NET Core/5+中的Console.ForegroundColor会映射为ANSI转义序列，但不同终端模拟器对颜色渲染存在差异。例如某些终端对DarkYellow的显示可能与Yellow混淆。对于跨平台应用，最好避免依赖过于细致的颜色区分，或者在文档中明确支持终端。
三、封装控制台颜色辅助类与最佳实践
在实际项目中频繁使用Console.ForegroundColor赋值和ResetColor容易导致代码重复，而且一旦忘记恢复默认颜色，可能会影响后续输出。因此推荐创建一个简单的静态辅助类，将常用的消息类型（如信息、成功、警告、错误）封装为带颜色输出的方法。例如：
using System;
public static class ConsoleLogger
{
public static void Info(string message)
{
Console.ForegroundColor = ConsoleColor.Gray;
Console.WriteLine(message);
Console.ResetColor();
}
public static void Success(string message)
{
Console.ForegroundColor = ConsoleColor.Green;
Console.WriteLine(message);
Console.ResetColor();
}
public static void Warning(string message)
{
Console.ForegroundColor = ConsoleColor.Yellow;
Console.WriteLine(message);
Console.ResetColor();
}
public static void Error(string message)
{
Console.ForegroundColor = ConsoleColor.Red;
Console.WriteLine(message);
Console.ResetColor();
}
}
这类封装不仅能减少重复代码，还能在将来需要统一调整颜色时只修改一个位置。如果需要在方法内部处理输出重定向，可以添加判断逻辑，避免在重定向时输出ANSI字符或浪费性能。
另一个最佳实践是使用using块来自动恢复颜色。虽然ConsoleColor属性不是IDisposable，但可以自己实现一个小型的作用域类，在构造时保存原颜色，在Dispose中恢复。这样即使中间抛出异常，颜色也能被恢复。示例：
using System;
public sealed class ConsoleColorScope : IDisposable
{
private readonly ConsoleColor _oldForeground;
private readonly ConsoleColor _oldBackground;
public ConsoleColorScope(ConsoleColor foreground, ConsoleColor background)
{
_oldForeground = Console.ForegroundColor;
_oldBackground = Console.BackgroundColor;
Console.ForegroundColor = foreground;
Console.BackgroundColor = background;
}
public void Dispose()
{
Console.ForegroundColor = _oldForeground;
Console.BackgroundColor = _oldBackground;
}
}
// 使用示例
using (new ConsoleColorScope(ConsoleColor.White, ConsoleColor.DarkRed))
{
Console.WriteLine("这段文本有特殊颜色");
}
// 离开using块后颜色自动恢复
最后，无论使用哪种方式，都要注意不要在性能敏感的循环中频繁调用ResetColor，因为每次重置都会涉及到底层终端操作。最佳做法是设置一次颜色，输出一批文本后再重置，而不是每输出一行就重置。
C#控制台颜色Console.ForegroundColor控制台颜色设置修改时间：2026-08-29 07:19:25