Лучший способ разбора аргументов командной строки в C#: от ручного парсинга до готовых библиотек

Рекомендуемый подход: библиотека CommandLineParser (NuGet)

Для .NET приложений (особенно если вы пишете на C#) лучший способ — использовать библиотеку CommandLineParser. Она доступна через NuGet, поддерживает все современные версии .NET (включая .NET Core/5/6/7/8) и решает 90% проблем с разбором аргументов: автоматическая валидация, поддержка длинных и коротких флагов, генерация справки.

Установка

dotnet add package CommandLineParser

Пример использования

Сначала определите класс с опциями:

using CommandLine;

public class Options
{
    [Option('i', "input", Required = true, HelpText = "Путь к входному файлу.")]
    public string Input { get; set; }

    [Option('o', "output", Required = false, Default = "output.txt", HelpText = "Путь к выходному файлу.")]
    public string Output { get; set; }

    [Option('v', "verbose", Default = false, HelpText = "Подробный вывод.")]
    public bool Verbose { get; set; }
}

Затем в Main используйте Parser:

static void Main(string[] args)
{
    Parser.Default.ParseArguments<Options>(args)
        .WithParsed<Options>(opts => RunWithOptions(opts))
        .WithNotParsed<Options>(errs => HandleErrors(errs));
}

static void RunWithOptions(Options opts)
{
    Console.WriteLine($"Input: {opts.Input}");
    Console.WriteLine($"Output: {opts.Output}");
    Console.WriteLine($"Verbose: {opts.Verbose}");
}

static void HandleErrors(IEnumerable<Error> errs)
{
    // По умолчанию библиотека сама выводит ошибки и справку
    // Здесь можно добавить свою логику, если нужно
    Environment.Exit(1);
}

Что даёт библиотека?

• Автоматическая валидация — если Required = true, а аргумент не передан, программа выдаст понятную ошибку.
• Поддержка коротких и длинных флагов — можно писать как --input file.txt, так и -i file.txt.
• Значения по умолчанию — если аргумент не указан, используется Default.
• Автоматическая справка — при запуске с --help или ошибке выводится сгенерированное описание на основе атрибутов.
• Обработка ошибок — библиотека сама проверяет, что после флага со значением идёт аргумент, а не другой флаг.

Дополнительные возможности

CommandLineParser поддерживает:

• Перечисления (Enum) — можно передавать --mode Fast.
• Списки — --files a.txt b.txt c.txt.
• Вложенные команды (например, git commit -m "message").
• Настраиваемые парсеры для кастомных типов.

Альтернатива: встроенный System.CommandLine

В .NET 6+ появилась библиотека System.CommandLine (входит в SDK), но она более многословна и требует .NET 6+. Для простых задач CommandLineParser удобнее.

Ваш код с ручным парсингом — это нормально для обучения, но в реальных проектах используйте готовые решения. Они экономят время, уменьшают количество багов и делают код чище.

static void Main(string[] args)
{
    var options = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
    var flags = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
    
    for (int i = 0; i < args.Length; i++)
    {
        string arg = args[i];
        
        if (arg.StartsWith("--"))
        {
            string key = arg.Substring(2);
            // Проверяем, есть ли значение (следующий аргумент не начинается с --)
            if (i + 1 < args.Length && !args[i+1].StartsWith("--"))
            {
                options[key] = args[++i];
            }
            else
            {
                flags.Add(key);
            }
        }
        else if (arg.StartsWith("-") && arg.Length == 2)
        {
            // Короткие флаги: -i, -o
            string key = arg.Substring(1);
            if (i + 1 < args.Length && !args[i+1].StartsWith("-"))
            {
                options[key] = args[++i];
            }
            else
            {
                flags.Add(key);
            }
        }
        else
        {
            Console.WriteLine($"Неизвестный аргумент: {arg}");
        }
    }

    string input = options.GetValueOrDefault("input") ?? options.GetValueOrDefault("i");
    string output = options.GetValueOrDefault("output") ?? options.GetValueOrDefault("o", "output.txt");
    bool verbose = flags.Contains("verbose") || flags.Contains("v");

    Console.WriteLine($"Input: {input}, Output: {output}, Verbose: {verbose}");
}