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