argparse中互斥参数必须用add_mutually_exclusive_group()创建组，再向组内添加参数；直接分开定义会导致无互斥效果。
argparse.ArgumentParser 里怎么加互斥参数组
互斥参数必须用 add_mutually_exclusive_group() 显式创建组，不能直接在 add_argument() 里设 flag。否则参数之间不会真正互斥，命令行传入多个时也不会报错。
常见错误是把 --verbose 和 --quiet 分开定义，结果两者能同时生效；正确做法是先调用 parser.add_mutually_exclusive_group()，再对返回的 group 对象调用 add_argument()：
group = parser.add_mutually_exclusive_group()
group.add_argument('--verbose', action='store_true')
group.add_argument('--quiet', action='store_true')
- 默认情况下 group 是 required=False，即允许都不传；如需强制选一个，加
required=True - group 不支持
action='count'这类复合行为，如果要实现 -v/-vv/-vvv，得自己解析sys.argv或改用action='append_const'配合nargs=0 - 同一个 group 里混用
action='store_true'和type=int会出错：argparse 按照第一个参数的 type 做统一校验，后面类型不一致就抛TypeError
argparse 的 type 参数怎么安全做自动转换
type 参数本质是函数调用，不是类型声明 —— 它接收原始字符串，返回转换后值；失败时抛 argparse.ArgumentTypeError 或任意异常（argparse 会捕获并格式化成错误提示）。
别直接写 type=int 处理可能为空或带单位的输入，比如 --timeout "30s"。应该封装自己的转换函数：
def parse_timeout(s):
if s.endswith('s'):
return int(s[:-1])
raise argparse.ArgumentTypeError(f'invalid timeout: {s!r}')
...
parser.add_argument('--timeout', type=parse_timeout)
- 内置类型如
int、float在转换失败时抛ValueError，argparse 会转成清晰报错；但自定义函数建议显式 raiseArgumentTypeError，避免堆栈信息暴露内部逻辑 -
type函数在解析阶段就被调用，早于action（如store_true），所以它只对传入的字符串起作用；如果参数被nargs='*'或nargs='+'包裹，type会对每个元素单独调用 - 不要在
type函数里做 IO 或网络请求，argparse 解析顺序不可控，且可能被多次调用（比如显示 help 时）
互斥组 + type 转换组合使用时的坑
当互斥组里多个参数都用了 type，且类型不同（比如一个 type=int，一个 type=str），argparse 不会报错，但实际运行时——只要用户传了对应参数，就会走各自的转换逻辑；问题在于：如果两个参数共用同一个 dest，值会被后解析的覆盖，而类型不一致会导致 Namespace 里的字段类型不稳定。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
更稳妥的做法是给每个互斥参数配独立 dest，再在解析后手动合并：
group = parser.add_mutually_exclusive_group()
group.add_argument('--port', type=int, dest='port', help='port number')
group.add_argument('--socket', type=str, dest='socket', help='unix socket path')
# 注意：这里没设 default，否则会干扰互斥判断
之后检查 args.port is not None 或 args.socket is not None 来分支处理。
- 别依赖
default值来判断是否传参，因为default会在所有参数解析前就写入Namespace；应始终用is None判断 - 如果互斥参数需要共享一个逻辑变量名（比如都映射到
args.endpoint），可用set_defaults()配合自定义Action子类，但复杂度陡增；简单脚本不如分开 dest + 后续 if/elif 清晰 - help 文本里别写“只能二选一”，argparse 自带的报错已经包含“not allowed with argument”提示，重复说明反而容易过时
为什么 --help 有时不显示互斥组的约束关系
argparse 默认只在 help 中列出参数，不自动标注“互斥”。只有当用户实际传入冲突参数（如同时用 --verbose --quiet）时，才报错提示。
想让 help 更友好，得手动加描述：
group = parser.add_mutually_exclusive_group()
group.add_argument('--verbose', action='store_true', help='enable verbose output')
group.add_argument('--quiet', action='store_true', help='suppress output (conflicts with --verbose)')
- argparse 不生成“conflicts with”这类元信息到 help，全靠人工维护；一旦 group 改动，help 文本容易漏同步
- 如果 group 里参数很多（比如 4 个日志级别），help 行数会爆炸，这时更适合用单个参数 +
choices=['debug','info','warn']替代互斥组 - help 字符串里出现的参数名，要用双横线格式（
--verbose），别写成verbose或args.verbose，否则用户看不懂
实际用下来，互斥逻辑越简单越好，优先考虑 choices 或布尔开关组合；真要上互斥组，就接受它带来的维护成本——尤其是 type 转换和 help 同步这两块，最容易在迭代中悄悄坏掉。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
