C#命令行参数解析（手把手教你处理控制台应用的命令行输入）

什么是命令行参数？

当你在终端（如 Windows 的 CMD 或 PowerShell、macOS/Linux 的 Terminal）中运行一个程序时，可以在程序名后面加上空格分隔的文本，这些文本就是命令行参数。例如：

MyApp.exe --input data.txt --output result.txt

在这个例子中，--input data.txt 和 --output result.txt 就是传递给 MyApp.exe 的命令行参数。

C# 中如何接收命令行参数？

在 C# 控制台应用中，命令行参数通过 Main 方法的参数自动传入。标准写法如下：

static void Main(string[] args){    // args 是一个字符串数组，包含所有传入的命令行参数}

这里的 args 就是一个字符串数组（string[]），每个元素对应一个命令行参数。例如，如果运行：

MyApp.exe hello world

那么 args[0] 是 "hello"，args[1] 是 "world"。

基础示例：打印所有参数

下面是一个简单的 C# 控制台程序，它会打印出所有接收到的命令行参数：

using System;class Program{    static void Main(string[] args)    {        Console.WriteLine($"共接收到 {args.Length} 个参数：");        for (int i = 0; i < args.Length; i++)        {            Console.WriteLine($"参数[{i}]: {args[i]}");        }    }}

编译并运行：dotnet run arg1 arg2 "hello world"，输出可能是：

共接收到 3 个参数：参数[0]: arg1参数[1]: arg2参数[2]: hello world

进阶：解析带选项的参数（如 --name value）

实际项目中，我们通常使用“键值对”形式的参数，例如 --config app.json。我们可以手动解析，也可以使用第三方库（如 System.CommandLine）。这里先展示一个简单的手动解析方法：

using System;using System.Collections.Generic;class Program{    static void Main(string[] args)    {        var options = new Dictionary<string, string>();        for (int i = 0; i < args.Length; i++)        {            if (args[i].StartsWith("--") || args[i].StartsWith("-"))            {                string key = args[i].TrimStart('-');                string value = (i + 1 < args.Length && !args[i + 1].StartsWith("-"))                                ? args[i + 1] : "true";                options[key] = value;                if (value != "true") i++; // 跳过下一个值            }        }        foreach (var kvp in options)        {            Console.WriteLine($"{kvp.Key} = {kvp.Value}");        }    }}

运行：dotnet run --name Alice --verbose，输出：

name = Aliceverbose = true

推荐：使用 System.CommandLine 库（官方推荐）

对于复杂项目，建议使用 .NET 官方提供的 System.CommandLine 库（需通过 NuGet 安装）。它能自动处理参数解析、帮助信息、类型转换等。

安装命令：

dotnet add package System.CommandLine

使用示例：

using System;using System.CommandLine;using System.CommandLine.Invocation;class Program{    static async Task<int> Main(string[] args)    {        var nameOption = new Option<string>(new[] { "--name", "-n" }, "用户姓名");        var verboseOption = new Option<bool>(new[] { "--verbose", "-v" }, "启用详细输出");        var rootCommand = new RootCommand("一个演示命令行参数解析的程序");        rootCommand.AddOption(nameOption);        rootCommand.AddOption(verboseOption);        rootCommand.SetHandler((name, verbose) =>        {            if (verbose)                Console.WriteLine("详细模式已启用");            Console.WriteLine($"你好，{name ?? "匿名用户"}！");        }, nameOption, verboseOption);        return await rootCommand.InvokeAsync(args);    }}

总结

通过本文，你已经掌握了 C#命令行参数解析 的基本方法，包括如何在 Main 方法中接收参数、手动解析键值对，以及使用官方推荐的 System.CommandLine 库。无论你是初学者还是有一定经验的开发者，都能根据项目复杂度选择合适的方案。

记住，良好的命令行参数设计能让你的 控制台应用参数处理 更加灵活和用户友好。如果你正在学习 C# Main方法参数 的用法，不妨动手写几个小例子试试看！

希望这篇 命令行参数教程 对你有帮助！欢迎分享给其他 C# 学习者。