在argparse中实现参数互斥最标准的方式是使用互斥组：调用add_mutually_exclusive_group()创建组，再用其add_argument()添加参数；默认允许都不提供但禁止同时提供，设required=True可强制二选一。
在 argparse 中，实现两个参数互斥（即不能同时出现）最标准的方式是使用 互斥组（mutually exclusive group） —— 通过 add_mutually_exclusive_group() 创建，再向其中添加参数。
创建互斥组并添加参数
调用 parser.add_mutually_exclusive_group() 得到一个组对象，然后用该组的 add_argument() 方法添加参数。这样，argparse 会在解析时自动检查是否有多于一个被指定，若违反则报错退出。
- 默认行为：至少一个可选（即允许都不提供），但不允许同时提供
- 如需强制二选一，可设
required=True（注意：仅对互斥组生效，不是单个参数）
基础示例：–verbose 和 –quiet 互斥
常见日志级别控制场景：
import argparse parser = argparse.ArgumentParser() group = parser.add_mutually_exclusive_group() group.add_argument('--verbose', action='store_true', help='启用详细输出') group.add_argument('--quiet', action='store_true', help='启用静默模式') args = parser.parse_args()✅ 允许：python script.py --verbose 或 python script.py --quiet 或 python script.py
❌ 禁止：python script.py --verbose --quiet → 报错：argument –quiet: not allowed with argument –verbose
强制二选一（require one of them）
只需在创建互斥组时传入 required=True：
group = parser.add_mutually_exclusive_group(required=True) group.add_argument('--input-file', type=str, help='输入文件路径') group.add_argument('--stdin', action='store_true', help='从标准输入读取')此时必须显式指定其中一个，否则报错：one of the arguments –input-file –stdin is required
注意事项与常见问题
- 互斥组只对
add_argument()调用有效；不能对已添加到 parser 的参数“事后”加入互斥关系 - 不支持跨组互斥（比如两个不同互斥组里的参数之间不会自动检查）
- 短选项（如
-v/-q）同样适用，只要加在同一互斥组里 - 如果参数有
nargs='*'或nargs='+'，互斥逻辑仍按“是否被提供”判断，而非内容是否重叠