System.CommandLine中如何在根/中间命令层级添加全局选项的通用处理程序

我完全明白你的痛点——不想在每个叶子命令里重复写全局选项的处理逻辑，希望根命令或者中间命令能统一做前置初始化，这完全符合DRY原则，太合理了！

首先得给你理清一个关键点：System.CommandLine 的命令处理器（Handler）机制默认是“独占”的——当你调用一个子命令（比如这里的leaf）时，只有该子命令的Handler会被触发执行，父命令（根命令）的Handler不会自动运行。这是框架的设计逻辑，不是bug，所以你之前期望根Handler先执行、再执行叶子Handler的思路，确实不符合当前的Handler运行规则。

那正确的解决方式是什么？答案是使用中间件（Middleware）——这是System.CommandLine专门为跨命令的通用逻辑（比如全局选项初始化、日志级别配置等）设计的功能，完全能满足你的需求！

中间件可以嵌入到命令的执行流程中，在目标命令的Handler运行之前或之后执行代码，而且能轻松访问所有绑定的选项值（包括全局选项）。下面是修改后的完整代码示例，完美实现你的需求：

var leaf = new Command("leaf", "A command that does some stuff");
var root = new RootCommand("The root command") { leaf };

var globalOption = new Option<string>("-g", "A global option");
root.AddGlobalOption(globalOption);

// 用中间件处理全局选项的通用初始化逻辑
root.UseMiddleware(async (context, next) =>
{
    // 从解析结果中获取全局选项的值
    var globalValue = context.ParseResult.GetValueForOption(globalOption);
    Console.WriteLine($"Set up things using the global option value {globalValue}");
    
    // 调用下一个中间件（最后会执行目标叶子命令的Handler）
    await next(context);
});

leaf.SetHandler(() => Console.WriteLine("Run the actual command after the global setup has completed"));

root.Invoke(args);

关键说明： #

1. 中间件的执行顺序：中间件会沿着命令树从根到叶子的顺序依次执行，父命令的中间件先运行，然后是子命令的中间件，最后才是目标命令的Handler。这完全符合你“先全局初始化、再执行叶子逻辑”的预期。
2. 复用性拉满：如果你的命令树有多层中间节点，也可以给中间命令添加中间件，它们都会按层级顺序执行，不用在每个叶子命令里重复任何初始化代码。
3. 支持异步逻辑：中间件天然支持async/await，如果你的初始化逻辑是异步的（比如配置数据库连接、初始化异步日志器），直接用异步中间件即可。
4. 访问上下文信息：通过InvocationContext，你可以获取到命令解析结果、绑定的选项/参数值，甚至可以修改执行流程（比如在某些条件下终止命令执行）。

之前你尝试的Handler机制，更适合处理该命令自身的逻辑，而中间件才是处理跨命令通用逻辑的正确打开方式——这也是框架官方推荐的做法，和是否处于beta阶段无关，是设计上的明确区分。

内容来源于stack exchange