C#如何创建支持--h/--help参数且可分页展示命令的控制台应用

完全可以实现，你可以借助.NET官方提供的命令行解析库避免手动处理参数，同时自定义帮助渲染逻辑即可支持分页查询能力，具体实现方案如下：

实现方案 #

1. 依赖选择 #

不需要手动编写参数解析逻辑，直接使用.NET官方维护的System.CommandLine库即可，它原生支持参数绑定、选项定义，还开放了帮助系统的自定义扩展能力。

2. 核心实现步骤 #

• 安装System.CommandLine NuGet包到你的控制台项目中
• 自定义--help选项，使其支持接收页码类型的参数
• 重写默认帮助输出逻辑，按页码拆分展示内容：
  • 预先统计所有需要展示的命令、选项总数量，按你预设的每页条数（比如10条/页）计算总页数
  • 对用户传入的页码做合法性校验，避免超出范围
  • 按页码截取对应区间的帮助条目输出，同时追加页码导航提示

3. 最小可运行示例 #

using System.CommandLine;

var rootCommand = new RootCommand("控制台工具演示");
// 定义支持接收页码的--help选项
var helpOption = new Option<int?>(
    aliases: new[] { "--help", "-h" },
    description: "查看帮助信息，后跟页码可直接跳转到对应页");
rootCommand.AddGlobalOption(helpOption);

// 模拟添加25条测试命令，用于演示分页
for (var i = 0; i < 25; i++)
{
    rootCommand.AddCommand(new Command($"cmd{i}", $"这是第{i}号测试命令的功能说明"));
}

// 绑定帮助逻辑
rootCommand.SetHandler((int? pageNum) =>
{
    const int pageSize = 10;
    var allItems = rootCommand.Subcommands.ToList();
    var totalPage = (int)Math.Ceiling(allItems.Count / (double)pageSize);
    var targetPage = Math.Clamp(pageNum ?? 1, 1, totalPage);

    // 输出当前页内容
    Console.WriteLine("=== 支持的命令列表 ===");
    var pageItems = allItems.Skip((targetPage - 1) * pageSize).Take(pageSize);
    foreach (var cmd in pageItems)
    {
        Console.WriteLine($"  {cmd.Name,-8} {cmd.Description}");
    }
    
    // 输出页码信息
    Console.WriteLine($"\n当前第 {targetPage} / {totalPage} 页");
    if (targetPage < totalPage)
    {
        Console.WriteLine($"输入 --help {targetPage + 1} 可查看下一页内容");
    }
}, helpOption);

// 启动命令行解析
await rootCommand.InvokeAsync(args);

4. 调用效果 #

编译后执行以下命令即可直接查看第二页的命令列表：
yourApp.exe --help 2

如果需要更复杂的帮助内容，你可以自行扩展逻辑，把全局选项、子命令的参数说明等内容也加入到分页展示的范围中。

内容的提问来源于stack exchange，提问作者VillyFiki