如何在Python Click中禁止同时传入多个功能开关？

嘿，这个问题其实不用自己写复杂的校验逻辑，Click本身就提供了完美的解决方案！针对这种互斥的功能开关场景，我们可以利用Click的互斥选项组特性，让框架自动帮我们处理多开关同时传入的情况。

方法一：通过命令上下文配置实现互斥 #

我们可以在定义命令时，通过context_settings参数指定哪些选项是互斥的。直接修改官方示例就能实现：

import click
import sys

@click.command(context_settings={"mutually_exclusive": [
    ("upper", "lower"),  # 指定--upper和--lower为互斥选项
]})
@click.option('--upper', 'transformation', flag_value='upper', default=True)
@click.option('--lower', 'transformation', flag_value='lower')
def info(transformation):
    click.echo(getattr(sys.platform, transformation)())

当用户同时传入--upper和--lower时，Click会自动抛出清晰的错误提示：

Error: Invalid value: Cannot use --upper and --lower together.

如果有三个及以上互斥选项，只需把它们放到同一个元组里即可：

@click.command(context_settings={"mutually_exclusive": [
    ("upper", "lower", "capitalize"),
]})
@click.option('--upper', 'transformation', flag_value='upper', default=True)
@click.option('--lower', 'transformation', flag_value='lower')
@click.option('--capitalize', 'transformation', flag_value='capitalize')
def info(transformation):
    click.echo(getattr(sys.platform, transformation)())

方法二：用选项组（Option Group）更直观管理互斥选项 #

如果你的Click版本在8.0及以上，更推荐用option_group的方式。这种写法不仅代码结构清晰，还能让帮助文档里的选项分组展示，可读性更强：

import click
import sys

@click.command()
@click.option_group(
    "文本转换选项",  # 选项组名称，会显示在帮助信息中
    click.option('--upper', 'transformation', flag_value='upper', default=True),
    click.option('--lower', 'transformation', flag_value='lower'),
    mutually_exclusive=True  # 开启组内选项互斥
)
def info(transformation):
    click.echo(getattr(sys.platform, transformation)())

这种方式的效果和第一种完全一致，只是代码逻辑更直观，用户查看帮助时能一眼识别出互斥选项组。

为什么不手动校验？ #

可能你会考虑自己在函数里统计传入的开关数量或判断参数来源，但这样不仅冗余，还要手动编写错误提示。不如直接用Click内置功能——它已经封装好了所有校验逻辑，还能生成标准化的错误信息，用户体验更好。

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