C#实现控制台多区域输出 前言#
如果经常使用一些Agent CLI工具，例如 Claude Code、Gemini CLI、OpenCode 等产品，会发现它们有一个共同特点：
虽然运行在终端之中，但已经完全不是传统命令行程序的样子。
在执行任务过程中，它们通常会同时展示：
Agent执行状态
思考过程
文件变更信息
Token统计
系统日志
工具调用结果
整个终端界面被划分成多个独立区域，并且每个区域都在实时刷新。
例如下面这种布局：
┌────────────────────┬────────────────────┐
│ Agent状态 │ Token统计 │
│ │ │
├────────────────────┴────────────────────┤
│ │
│ 执行过程区域 │
│ │
├─────────────────────────────────────────┤
│ 系统日志 │
└─────────────────────────────────────────┘
上次在微信群里看到黑洞大佬在做类似的Agent CLI谈到过控制台多区域输出的问题，我当时比较好奇：
C# 原生 Console 是如何实现多区域动态界面的呢？
经过一番研究之后发现，实现原理并没有想象中复杂。
本文通过一个简单示例，介绍如何利用 C# Console 实现：
多区域布局
动态内容刷新
滚动日志窗口
多线程安全输出
优雅退出机制
Console为什么能够实现多区域输出#
大多数情况下，我们使用 Console 都是这样：
Console.WriteLine(“任务开始”);
for (int i = 0; i < 10; i++)
{
Console.WriteLine($“执行进度：{i}”);
}
Console.WriteLine(“任务结束”);
输出结果如下：
任务开始
执行进度：0
执行进度：1
执行进度：2
…
任务结束
看起来控制台只能从上往下不断输出内容。
实际上 Console 还提供了一组非常重要的API：
Console.SetCursorPosition(x, y);
它允许程序直接控制光标位置。
例如：
Console.SetCursorPosition(10, 5);
Console.Write(“Hello”);
程序会直接在指定坐标位置输出内容。
也就是说：
Console ≠ 输出流
而更像是：
Console = 字符画布
只要能够控制坐标位置，就能够实现区域划分与动态刷新。
这也是所有终端UI框架最基础的实现原理。
实现控制台布局#
首先需要将控制台划分成多个区域。
本示例将控制台分成三个部分：
左上区域显示系统时间
右上区域显示任务进度
下半区域显示运行日志
布局绘制代码如下：
static void DrawLayout()
{
int width = Console.WindowWidth;
int height = Console.WindowHeight;
int midX = width / 2; int midY = height / 2; for (int y = 0; y < midY; y++) { SafeWrite(midX, y, "│"); } for (int x = 0; x < width - 1; x++) { SafeWrite(x, midY, "─"); } SafeWrite(2, 0, "[ 系统时间 ]"); SafeWrite(midX + 2, 0, "[ 任务进度 ]"); SafeWrite(2, midY + 1, "[ 运行日志 (滚动) ]");}
运行之后界面如下：
image
整个布局没有使用任何第三方组件。
本质上就是利用字符绘制边框。
实现系统时间区域#
布局完成之后，实现左上角的时间显示区域。
代码如下：
static void UpdateRegion_Clock()
{
while (_isRunning)
{
SafeWrite(
2,
2,
DateTime.Now.ToString(“yyyy-MM-dd HH:mm:ss”));
Thread.Sleep(1000); }}
运行效果：
2026-05-21 16:30:25
由于始终输出到同一个位置，因此每次刷新都会覆盖之前的内容。
从而形成动态更新时间的效果。
实现任务进度区域#
右上角区域用于模拟任务进度。
实现代码如下：
static void UpdateRegion_Progress()
{
int progress = 0;
int midX = Console.WindowWidth / 2;
while (_isRunning) { progress = (progress + 1) % 101; int barWidth = 20; int filled = (int)(barWidth * (progress / 100.0)); string bar = "[" + new string('█', filled) + new string(' ', barWidth - filled) + $"] {progress}%"; SafeWrite(midX + 2, 2, bar); Thread.Sleep(50); }}
运行效果如下：
[██████████████ ] 72%
这种实现方式和很多安装程序、下载工具中的进度条实现原理基本一致。
实现滚动日志窗口#
日志区域是整个示例最核心的部分。
如果简单使用：
Console.WriteLine();
日志会不断向下滚动。
很快就会占满整个控制台。
因此需要一个固定区域用于展示日志内容。
首先定义日志队列：
private static readonly Queue
_logQueue = new Queue();
新增日志：
_logQueue.Enqueue(
new LogEntry
{
Text = newLog,
Color = color
});
超过最大显示行数时移除旧日志：
while (_logQueue.Count > _maxLogLines)
{
_logQueue.Dequeue();
}
然后重新绘制日志区域：
foreach (var log in _logQueue)
{
Console.SetCursorPosition(2, currentY);
Console.ForegroundColor = log.Color;
Console.Write(log.Text);
currentY++;}
运行效果如下：
15:32:11.212 [INFO ] 初始化完成
15:32:11.518 [INFO ] 加载配置文件
15:32:11.802 [DEBUG] 创建任务
15:32:12.015 [WARN ] Token接近阈值
15:32:12.381 [ERROR] 请求超时
15:32:12.912 [INFO ] 自动重试成功
同时根据日志等级设置不同颜色：
static ConsoleColor GetLogLevelColor(string level)
{
switch (level)
{
case “ERROR”:
return ConsoleColor.Red;
case “WARN”:
return ConsoleColor.Yellow;
case “DEBUG”:
return ConsoleColor.DarkGray;
default:
return ConsoleColor.Green;
}
}
这样整个日志区域看起来就更接近真实系统运行效果。
多线程下的控制台竞争问题#
到这里，一个新的问题出现了。
当前程序存在三个后台线程：
时间刷新线程
进度刷新线程
日志刷新线程
这些线程都会同时操作控制台。
例如：
Console.SetCursorPosition(x, y);
Console.Write(text);
如果多个线程同时执行，很容易出现输出错乱。
因此需要统一加锁。
首先定义控制台锁对象：
private static readonly object _consoleLock =
new object();
然后封装安全输出方法：
static void SafeWrite(
int x,
int y,
string text)
{
lock (_consoleLock)
{
Console.SetCursorPosition(x, y);
Console.Write(text);
}
}
后续所有区域输出都通过该方法完成。
这样能够保证同一时刻只有一个线程修改控制台状态。
避免多个线程抢占光标位置导致界面错乱。
优雅退出机制#
很多控制台程序都会忽略退出逻辑。
例如按下 Ctrl+C 之后：
程序被强制终止
此时可能出现：
光标未恢复
输出颜色异常
界面残留