C#实现控制台交互式操作

前言

上一篇文章《C#实现控制台多区域输出》中，我们介绍了如何利用 Console 实现类似 Agent CLI 的多区域动态界面。

如果说多区域布局解决的是：

text 复制代码

界面如何展示的问题

那么本文要讨论的则是另外一个问题：

text 复制代码

用户如何与界面交互

相信体验过Claude Code、OpenCode、Hermes 等工具的同学，经常能够看到类似界面：

text 复制代码

请选择模型：

> GPT-4.1
  Claude Sonnet
  Gemini Pro

或者：

text 复制代码

即将修改以下文件：

Program.cs
appsettings.json

是否继续？

[ 是 ]  [ 否 ]

这些效果看起来已经完全不像传统的命令行程序。

相比与：

text 复制代码

请输入数字编号：

这种交互方式显然更加直观，交互性更强。

本文就通过两个简单示例，分析这些终端交互效果背后的实现原理：

列表菜单
确认选择框

看看这些在 Agent CLI 中随处可见的交互组件，如果使用原生的控制台方式究竟是如何实现的。

传统CLI与现代CLI

很多传统的控制台程序都是这样工作的：

text 复制代码

请选择操作：

1.启动服务
2.停止服务
3.重启服务

请输入编号：

用户输入：

text 复制代码

程序继续执行。

这种交互的模式本质上是：

text 复制代码

输入
↓
提交
↓
执行

而现代 CLI 更倾向于：

text 复制代码

实时交互
↓
实时反馈
↓
状态更新

例如：

text 复制代码

请选择操作：
> 启动服务
  停止服务
  重启服务

用户按下方向键时变成：

text 复制代码

  启动服务
> 停止服务
  重启服务

整个过程不需要输入任何字符, 这也是各种 Agent CLI 非常喜欢采用的交互方式。

实现一个列表菜单

先来看一个最常见的场景。

例如系统运维工具：

text 复制代码

请选择执行操作：
> 启动系统服务
  停止系统服务
  重启数据库
  清理系统缓存
  查看运行日志
  退出程序

用户通过↑ ↓随意切换选项, 通过Enter确认选择, 最终返回用户选中的菜单项。

菜单数据定义

首先准备菜单数据：

csharp 复制代码

string[] options =
{
    "启动系统服务",
    "停止系统服务",
    "重启数据库",
    "清理系统缓存",
    "查看运行日志",
    "退出程序"
};

然后调用菜单组件：

csharp 复制代码

int selectedIndex = ShowSelectionMenu(options);

该方法最终会返回0 1 2 3对应用户选择的菜单项。

菜单核心实现

整个菜单真正核心的代码其实并不多：

csharp 复制代码

static int ShowSelectionMenu(string[] options)
{
    Console.CursorVisible = false;

    int selectedIndex = 0;
    int startY = Console.CursorTop;

    while (true)
    {
        DrawMenu(options,  selectedIndex, startY);

        ConsoleKeyInfo keyInfo  = Console.ReadKey(true);

        switch (keyInfo.Key)
        {
            case ConsoleKey.UpArrow:
                selectedIndex--;

                if (selectedIndex < 0)
                {
                    selectedIndex = options.Length - 1;
                }
                break;

            case ConsoleKey.DownArrow:
                selectedIndex++;

                if (selectedIndex >= options.Length)
                {
                    selectedIndex = 0;
                }
                break;

            case ConsoleKey.Enter:
                Console.CursorVisible = true;
                return selectedIndex;
        }
    }
}

整个流程其实非常清晰：

text 复制代码

绘制菜单
↓
等待按键
↓
修改状态
↓
重新绘制菜单

不断循环直到用户按下Enter。

菜单绘制逻辑

菜单的绘制代码如下：

csharp 复制代码

static void DrawMenu(string[] options, int selectedIndex, int startY)
{
    for (int i = 0; i < options.Length; i++)
    {
        Console.SetCursorPosition(0, startY + i);
        Console.Write( new string(' ', Console.WindowWidth - 1));
        Console.SetCursorPosition(0,  startY + i);

        if (i == selectedIndex)
        {
            Console.BackgroundColor = ConsoleColor.White;
            Console.ForegroundColor =  ConsoleColor.Black;
            Console.Write($"> {options[i]}");
        }
        else
        {
            Console.Write($"  {options[i]}");
        }

        Console.ResetColor();
    }
}

运行效果：

这里有一个非常重要的细节。

为什么每次都要重绘

很多人第一次写菜单时都会这样：

csharp 复制代码

Console.Write(text);

然后发现界面开始出现残影。

例如：

text 复制代码

> Restart Database

切换成：

text 复制代码

> Stop

之后可能变成：

text 复制代码

> Stopart Database

原因很简单：

text 复制代码

Console不会自动清理旧的内容

因此每次刷新之前必须先清空区域：

csharp 复制代码

Console.Write(new string(' ',  Console.WindowWidth - 1));

然后重新绘制, 这也是很多终端UI框架的核心思想：

text 复制代码

状态变化
↓
区域重绘

而不是：

text 复制代码

修改控件

实现确认选择框

菜单实现完成之后, 我们再来看另外一个非常常见的交互组件。

例如：

text 复制代码

是否继续执行？

[ 是 ]    [ 否 ]

这种效果在：

文件删除
权限授权
配置确认
Agent工具调用

等需要确认的场景中很常见。

确认框核心实现

因为确认框本质上只有两个状态是否, 因此实现反而更容易实现。

核心代码如下：

csharp 复制代码

static bool ShowConfirmation(string message)
{
    Console.WriteLine(message);

    int selectedIndex = 0;
    int startY = Console.CursorTop;

    while (true)
    {
        DrawConfirmation(selectedIndex, startY);
        ConsoleKeyInfo keyInfo = Console.ReadKey(true);

        switch (keyInfo.Key)
        {
            case ConsoleKey.LeftArrow:
                selectedIndex--;
                break;

            case ConsoleKey.RightArrow:
                selectedIndex++;
                break;

            case ConsoleKey.Tab:
                selectedIndex++;
                break;

            case ConsoleKey.Enter:
                return selectedIndex == 0;
        }

        if (selectedIndex < 0)
        {
            selectedIndex = 1;
        }

        if (selectedIndex > 1)
        {
            selectedIndex = 0;
        }
    }
}

上面的方法最终返回true或者false

确认框绘制逻辑

对应的绘制代码：

csharp 复制代码

static void DrawConfirmation(int selectedIndex, int startY)
{
    Console.SetCursorPosition(0,  startY);
    Console.Write(new string(' ',  Console.WindowWidth - 1));
    Console.SetCursorPosition( 0, startY);

    if (selectedIndex == 0)
    {
        Highlight();
    }

    Console.Write("[ 是 ]");
    Console.ResetColor();
    Console.Write("    ");

    if (selectedIndex == 1)
    {
        Highlight();
    }

    Console.Write("[ 否 ]");
    Console.ResetColor();
}

效果如下：

从实现角度来看，与菜单并没有本质区别。

菜单和确认框的共同点

看到这里会发现, 虽然菜单和确认框长得完全不同。

菜单：

text 复制代码

> 启动服务
  停止服务

确认框：

text 复制代码

[ 是 ] [ 否 ]

但背后的逻辑完全一致。

第一部分：状态

无论什么交互组件, 都需要维护状态。

例如：

csharp 复制代码

int selectedIndex;

表示：

text 复制代码

当前选中了什么

第二部分：渲染

根据状态绘制界面：

csharp 复制代码

DrawMenu();

或者：

csharp 复制代码

DrawConfirmation();

状态决定界面长什么样。

第三部分：输入

等待用户操作：

csharp 复制代码

Console.ReadKey(true);

获取：

text 复制代码

↑
↓
←
→
Tab
Enter

第四部分：更新状态

根据按键l来修改状态：

csharp 复制代码

selectedIndex++;

或者：

csharp 复制代码

selectedIndex--;

第五部分：重新渲染

状态发生变化之后：

text 复制代码

重新绘制界面

整个过程可以抽象成：

text 复制代码

初始化状态
↓
渲染界面
↓
等待输入
↓
更新状态
↓
重新渲染

其实绝大多数终端交互组件都遵循这一模式。

由于篇幅有限，本文只展示了核心实现。有兴趣的同学可以自行查看完整示例:

https://github.com/softlgl/ConsoleMultiRegion

用这些能力实现一个Agent配置向导

掌握菜单和确认框之后, 其实已经能够实现很多 Agent CLI 中的交互界面。

例如：

text 复制代码

请选择模型：
> GPT-4.1
  Claude Sonnet
  Gemini Pro

选择完成：

text 复制代码

请选择运行模式：
> 自动模式
  手动模式

继续：

text 复制代码

是否启用联网搜索？
[ 是 ]    [ 否 ]

最终：

text 复制代码

配置完成

整个过程实际上只是：

text 复制代码

菜单
+
确认框
+
状态管理

的组合。

总结

上一篇文章中，我们实现了 Console 的多区域动态布局, 而本文则进一步实现了控制台程序中的交互能力。

通过菜单和确认框两个简单示例，可以发现现代 CLI 的很多交互效果并没有想象中复杂。其核心无非是：

text 复制代码

状态管理
↓
键盘输入
↓
区域重绘

所以很多看起来十分高级的交互界面，最终追溯到底层实现，其实都建立在这些最基础的能力之上。

👇欢迎扫码关注我的公众号👇