C# 如何解析命令行参数 - 手动解析与System.CommandLine库

在C#控制台应用开发中，命令行参数解析是处理用户输入、配置程序运行逻辑的基础环节，不同的解析方式对应不同的开发需求和场景，开发者可以根据项目实际情况灵活选择。

手动解析命令行参数的实现

手动解析适合参数数量少、逻辑简单的场景，核心思路是遍历程序入口的args数组，根据参数格式自行拆分和匹配。常见的命令行参数格式有两种，一种是-参数名 参数值的形式，另一种是--参数名=参数值的形式，手动解析时需要同时兼容这两种情况。

以下是一个简单的手动解析示例，支持解析--name和--age两个参数，同时处理参数缺失的异常情况：

using System;

class Program
{
    static void Main(string[] args)
    {
        string name = null;
        int? age = null;
        // 遍历参数数组
        for (int i = 0; i < args.Length; i++)
        {
            string arg = args[i];
            // 处理 --name=xxx 格式
            if (arg.StartsWith("--name="))
            {
                name = arg.Substring("--name=".Length);
            }
            // 处理 -name xxx 格式
            else if (arg == "--name" || arg == "-name")
            {
                if (i + 1 < args.Length)
                {
                    name = args[i + 1];
                    i++; // 跳过下一个参数值
                }
            }
            // 处理 --age=xxx 格式
            else if (arg.StartsWith("--age="))
            {
                if (int.TryParse(arg.Substring("--age=".Length), out int parsedAge))
                {
                    age = parsedAge;
                }
            }
            // 处理 -age xxx 格式
            else if (arg == "--age" || arg == "-age")
            {
                if (i + 1 < args.Length && int.TryParse(args[i + 1], out int parsedAge))
                {
                    age = parsedAge;
                    i++; // 跳过下一个参数值
                }
            }
        }
        // 校验必填参数
        if (string.IsNullOrEmpty(name))
        {
            Console.WriteLine("错误：缺少必填参数 --name");
            return;
        }
        Console.WriteLine($"解析结果：姓名={name}，年龄={age?.ToString() ?? "未设置"}");
    }
}

手动解析的优势是无需引入额外依赖，代码逻辑完全可控，但是当参数数量增多、需要支持子命令、参数校验规则复杂时，手动编写的逻辑会变得冗长，后期维护成本也会明显上升。

使用System.CommandLine库解析参数

System.CommandLine是微软官方维护的命令行解析库，提供了完整的参数定义、校验、帮助信息生成、子命令支持等功能，适合参数复杂、需要规范交互的C#控制台应用。使用前需要先通过NuGet安装System.CommandLine包，安装完成后即可在代码中引用相关类型。

以下是使用System.CommandLine实现和上述手动解析相同功能的示例，代码逻辑更简洁，还自动生成了帮助信息：

using System;
using System.CommandLine;

class Program
{
    static void Main(string[] args)
    {
        // 定义根命令
        var rootCommand = new RootCommand("命令行参数解析示例程序");
        // 定义 name 参数，设置为必填
        var nameOption = new Option<string>("--name", "用户姓名")
        {
            IsRequired = true
        };
        nameOption.AddAlias("-n"); // 添加短别名
        rootCommand.AddOption(nameOption);
        // 定义 age 参数，设置为可选
        var ageOption = new Option<int?>("--age", "用户年龄");
        ageOption.AddAlias("-a"); // 添加短别名
        rootCommand.AddOption(ageOption);
        // 设置命令执行逻辑
        rootCommand.SetHandler((name, age) =>
        {
            Console.WriteLine($"解析结果：姓名={name}，年龄={age?.ToString() ?? "未设置"}");
        }, nameOption, ageOption);
        // 执行命令解析
        rootCommand.Invoke(args);
    }
}

运行程序时如果输入--help参数，库会自动生成格式规范的使用说明，无需开发者手动编写。同时该库内置了参数类型校验、重复参数检测等能力，减少了手动编写校验逻辑的工作量。

两种方式的适用场景对比

可以通过下表快速判断两种方式的选择依据：

如果项目是简单的临时脚本，参数数量很少，手动解析完全可以满足需求；如果是需要长期迭代、参数可能不断扩展的正式应用，使用System.CommandLine库能降低后续开发和维护的负担，让代码逻辑更清晰。

C#命令行参数解析手动解析System.CommandLine控制台应用修改时间：2026-06-08 17:39:30