如何用System.CommandLine实现--[no-]bool-option布尔选项？

在很多主流CLI工具中，都支持--[no-]flag形式的布尔选项，遵循最后出现者生效的规则——比如执行prog --flag --flag --no-flag后，最终flag的值为false，Git的git-fetch命令就有这类选项。

如果用System.CommandLine简单实现，常规做法是定义两个Option<bool?>分别对应--flag和--no-flag，但这种方式没法直接获取参数的出现顺序，还容易出现两个选项状态不同步的问题。

原生支持情况 #

System.CommandLine 2.0及以上版本已经原生支持这种双向布尔切换选项，不需要手动定义两个独立选项。

官方推荐实现方案 #

只需要定义一个普通的Option<bool>，通过配置启用双向开关特性，框架会自动处理--no-前缀的别名，同时自动遵循“最后出现者生效”的规则：

// 定义双向布尔选项
var flagOption = new Option<bool>(
    name: "--flag",
    description: "启用或禁用目标功能",
    // 默认值可根据需求设置
    getDefaultValue: () => false)
{
    // 关键配置：启用双向切换，自动识别--no-flag别名
    IsToggle = true
};

var rootCommand = new RootCommand("支持--[no-]flag的示例CLI");
rootCommand.AddOption(flagOption);

// 设置处理逻辑
rootCommand.SetHandler((bool flag) =>
{
    Console.WriteLine($"最终flag状态: {flag}");
}, flagOption);

await rootCommand.InvokeAsync(args);

测试验证：

• 执行prog --flag --flag --no-flag，输出最终flag状态: False
• 执行prog --no-flag --flag，输出最终flag状态: True
• 不添加任何选项，输出默认值最终flag状态: False

旧版本兼容方案（2.0之前） #

如果无法升级到2.0+版本，可以通过解析上下文获取所有匹配的令牌，手动判断最后出现的选项来确定最终值，不需要弃用框架的解析能力：

var flagOption = new Option<bool?>(name: "--flag", description: "启用功能");
var noFlagOption = new Option<bool?>(name: "--no-flag", description: "禁用功能");

var rootCommand = new RootCommand();
rootCommand.AddOption(flagOption);
rootCommand.AddOption(noFlagOption);

rootCommand.SetHandler((ParseResult result) =>
{
    // 获取所有匹配的选项令牌，按出现顺序排列
    var toggleTokens = result.Tokens
        .Where(t => t.Type == TokenType.Option 
            && (t.Value == "--flag" || t.Value == "--no-flag"))
        .ToList();

    // 默认状态，可根据需求调整
    bool finalFlag = false;
    if (toggleTokens.Any())
    {
        // 取最后一个令牌判断状态
        finalFlag = toggleTokens.Last().Value == "--flag";
    }

    Console.WriteLine($"最终flag状态: {finalFlag}");
});

await rootCommand.InvokeAsync(args);

这种方式可以完美解决选项顺序和同步的问题，同时保留System.CommandLine的参数解析能力。

内容的提问来源于stack exchange，提问作者Sean Allred