C#控制台应用命令函数调用实战：从参数解析到模块化设计

1次阅读

没有评论

共计 2005 个字符，预计需要花费 6 分钟才能阅读完成。

开发 C# 控制台应用时，手动解析命令行参数是个常见但繁琐的任务。每次都要写一堆 if-else 判断参数，不仅代码冗长，还容易出错。更糟的是，随着功能增加，代码会变得越来越难以维护。

传统方式需要手动解析 args 数组，处理各种参数组合
命令和参数验证逻辑散落在代码各处，难以统一管理
添加新命令时，需要修改主逻辑，违反了开闭原则

为了解决这些问题，我们设计了一个基于反射和特性标注的模块化方案。核心思路是：

使用 [Command] 特性标记可执行的方法
通过反射自动发现这些命令方法
利用 ParameterInfo 实现类型安全的参数绑定

与 System.CommandLine 相比，这个方案更轻量，更适合需要高度自定义的场景。

public class CommandExecutor
{
    private readonly Dictionary<string, MethodInfo> _commandCache;

    public CommandExecutor()
    {_commandCache = new Dictionary<string, MethodInfo>(StringComparer.OrdinalIgnoreCase);
    }

    public void RegisterCommands(Assembly assembly)
    {foreach (var type in assembly.GetTypes())
        {foreach (var method in type.GetMethods())
            {var attr = method.GetCustomAttribute<CommandAttribute>();
                if (attr != null)
                {_commandCache[attr.Name ?? method.Name] = method;
                }
            }
        }
    }

    public async Task ExecuteAsync(string commandName, string[] args)
    {if (!_commandCache.TryGetValue(commandName, out var method))
            throw new CommandNotFoundException(commandName);

        // 参数解析和类型转换逻辑...
    }
}

[AttributeUsage(AttributeTargets.Method)]
public class CommandAttribute : Attribute
{public string Name { get;}
    public string Description {get; set;}

    public CommandAttribute(string name = null)
    {Name = name;}
}

我们定义了自定义异常类来处理各种错误情况：

public class CommandException : Exception
{public CommandException(string message) : base(message) {}}

public class CommandNotFoundException : CommandException
{public CommandNotFoundException(string commandName) 
        : base($"Command'{commandName}'not found") {}}

为了避免运行时反射的性能开销，可以使用 Source Generator 在编译时生成命令路由表：

[Generator]
public class CommandSourceGenerator : ISourceGenerator
{public void Initialize(GeneratorInitializationContext context) { }

    public void Execute(GeneratorExecutionContext context)
    {// 扫描程序集中的 Command 方法并生成路由代码}
}

处理异步命令时需要注意：