C#实现控制台多区域输出

近一年以来，AI Agent的发展速度非常快。
如果经常使用一些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, "[ 运行日志 (滚动) ]"); }

运行之后界面如下：

整个布局没有使用任何第三方组件。
本质上就是利用字符绘制边框。

实现系统时间区域#

布局完成之后，实现左上角的时间显示区域。
代码如下：

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<LogEntry> _logQueue = new Queue<LogEntry>();

新增日志：

_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); } }

后续所有区域输出都通过该方法完成。
这样能够保证同一时刻只有一个线程修改控制台状态。
避免多个线程抢占光标位置导致界面错乱。

优雅退出机制#