在C#中开发命令行应用程序时，处理用户输入的命令行参数是核心功能之一，无论是简单的配置传入还是复杂的指令执行，都需要先正确获取并解析参数。C#本身提供了多种获取和解析命令行参数的方式，同时也有成熟的第三方库可以简化复杂场景的处理逻辑。
C#获取命令行参数的默认方式
最基础的获取命令行参数的方式是通过Main方法的参数，C#控制台程序的入口Main方法默认支持带字符串数组参数的重载形式，这个数组就是程序启动时传入的命令行参数集合。
Main方法参数获取
当我们创建C#控制台项目时，默认的Main方法没有参数，我们可以手动修改为带string[] args的形式，运行时系统会自动将命令行输入的参数按空格分割后存入这个数组。
下面是一个简单的示例，打印所有传入的命令行参数：
using System;
namespace CommandLineDemo
{
class Program
{
static void Main(string[] args)
{
// 判断是否有传入参数
if (args.Length == 0)
{
Console.WriteLine("未传入任何命令行参数");
return;
}
// 遍历打印所有参数
Console.WriteLine("传入的命令行参数如下：");
for (int i = 0; i < args.Length; i++)
{
Console.WriteLine($"参数{i + 1}：{args[i]}");
}
}
}
}
如果我们在命令行中执行程序时输入dotnet run --name 张三 --age 20，那么args数组的内容依次是--name、张三、--age、20，数组长度为4。
Environment类获取参数
除了通过Main方法的参数获取，还可以使用Environment.GetCommandLineArgs()方法获取命令行参数，这个方法的返回值是字符串数组，第一个元素始终是程序的完整路径，后续的才是用户传入的参数。
using System;
namespace CommandLineDemo
{
class Program
{
static void Main(string[] args)
{
// 获取所有命令行参数
string[] allArgs = Environment.GetCommandLineArgs();
Console.WriteLine("通过Environment获取的参数：");
foreach (var arg in allArgs)
{
Console.WriteLine(arg);
}
}
}
}
同样是上面的执行命令，这个方法的返回值第一个元素是程序路径，之后才是--name、张三、--age、20，使用时需要注意跳过第一个元素。
基础命令行参数解析逻辑
获取到原始参数数组后，我们需要根据参数的格式进行解析，常见的参数格式有两种，一种是键值对形式，比如--name 张三，另一种是标志位形式，比如--debug。
键值对参数解析
键值对参数通常需要成对出现，我们可以通过遍历参数数组，判断以--开头的参数为键，下一个参数为对应的值，实现简单的解析逻辑。
using System;
using System.Collections.Generic;
namespace CommandLineDemo
{
class Program
{
static void Main(string[] args)
{
// 存储解析后的键值对参数
Dictionary<string, string> paramDict = new Dictionary<string, string>();
for (int i = 0; i < args.Length; i++)
{
// 判断是否是参数键，以--开头
if (args[i].StartsWith("--"))
{
string key = args[i].Substring(2);
// 判断下一个参数是否存在且不是新的键
if (i + 1 < args.Length && !args[i + 1].StartsWith("--"))
{
paramDict[key] = args[i + 1];
i++; // 跳过已经处理的值参数
}
else
{
// 没有对应值的参数，作为标志位处理
paramDict[key] = "true";
}
}
}
// 打印解析结果
Console.WriteLine("解析后的参数：");
foreach (var item in paramDict)
{
Console.WriteLine($"{item.Key}：{item.Value}");
}
}
}
}
执行dotnet run --name 张三 --age 20 --debug，解析结果会是name：张三、age：20、debug：true，符合我们的预期。
参数校验逻辑
解析完参数后通常需要对必填参数进行校验，比如某些业务场景下name参数是必须的，我们可以这样实现校验：
using System;
using System.Collections.Generic;
namespace CommandLineDemo
{
class Program
{
static void Main(string[] args)
{
Dictionary<string, string> paramDict = new Dictionary<string, string>();
for (int i = 0; i < args.Length; i++)
{
if (args[i].StartsWith("--"))
{
string key = args[i].Substring(2);
if (i + 1 < args.Length && !args[i + 1].StartsWith("--"))
{
paramDict[key] = args[i + 1];
i++;
}
else
{
paramDict[key] = "true";
}
}
}
// 校验必填参数name
if (!paramDict.ContainsKey("name"))
{
Console.WriteLine("错误：缺少必填参数--name");
return;
}
Console.WriteLine($"欢迎用户：{paramDict["name"]}");
}
}
}
使用第三方库简化解析
当需要处理的参数较多、格式复杂时，自己实现解析逻辑会比较繁琐，此时可以使用成熟的第三方库，比如CommandLineParser，它支持自动映射参数到类属性、自动生成帮助文档等功能。
安装CommandLineParser库
首先通过NuGet安装CommandLineParser包，在命令行中执行：
dotnet add package CommandLineParser
定义参数模型类
我们可以定义一个类来映射命令行参数，通过特性标记参数的名称、是否必填、帮助信息等：
using CommandLine;
namespace CommandLineDemo
{
// 定义参数模型类
class Options
{
// 映射--name参数，设置帮助信息
[Option('n', "name", Required = true, HelpText = "用户名称")]
public string Name { get; set; }
// 映射--age参数，设置默认值
[Option('a', "age", Default = 18, HelpText = "用户年龄")]
public int Age { get; set; }
// 映射--debug标志位
[Option('d', "debug", Default = false, HelpText = "是否开启调试模式")]
public bool Debug { get; set; }
}
}
使用库解析参数
然后在Main方法中使用Parser类进行参数解析：
using System;
using CommandLine;
using CommandLine.Text;
namespace CommandLineDemo
{
class Program
{
static void Main(string[] args)
{
// 解析命令行参数
ParserResult<Options> result = Parser.Default.ParseArguments<Options>(args);
result.WithParsed(options =>
{
// 解析成功，使用参数
Console.WriteLine($"用户名称：{options.Name}");
Console.WriteLine($"用户年龄：{options.Age}");
Console.WriteLine($"调试模式：{options.Debug}");
}).WithNotParsed(errors =>
{
// 解析失败，打印错误信息
Console.WriteLine("参数解析失败：");
foreach (var error in errors)
{
Console.WriteLine(error);
}
// 打印帮助文档
Console.WriteLine(HelpText.AutoBuild(result));
});
}
}
}
执行dotnet run --name 李四 --age 25 --debug，会正确输出解析后的参数，如果缺少必填的--name参数，会自动打印错误信息和帮助文档，大大减少了手动处理的工作量。
常见问题与注意事项
- 参数中包含空格时，需要用英文双引号包裹，比如
--address "北京市海淀区"，否则会被分割成多个参数。 - 参数中的特殊字符如果和命令行语法冲突，需要进行转义处理，不同终端的转义规则略有差异。
- 使用
Environment.GetCommandLineArgs()时，第一个元素是程序路径，解析时记得跳过，避免逻辑错误。 - 第三方库的版本需要和项目的.NET版本兼容，安装前可以查看库的版本支持说明。