argparse不支持多组互斥原生，需用add_mutually_exclusive_group()分别创建group1和group2；子命令共享父参数须用parents=[parent_parser]且父参数required=false；“unrecognized arguments”因传入未声明参数，可用parse_known_args()定位；隐藏默认值需在help中手动描述而不依赖自动显示。
argparse.ArgumentParser 的 add_argument 如何支持多个互斥参数组
argparse 本身不提供“多组互斥”原生支持，add_mutually_exclusive_group() 只能建一组。真要实现「A/B 互斥」且「C/D 互斥」，得手动建两个独立组，并显式控制逻辑。
常见错误是把所有选项塞进同一个 add_mutually_exclusive_group()，结果变成 A/B/C/D 全互斥，违背本意。
- 用
parser.add_mutually_exclusive_group(required=False)分别创建group1和group2 - 每个组内加自己的
add_argument()，比如group1.add_argument('--env', choices=['dev','prod'])和group1.add_argument('--config', type=str) - 如果业务上要求「至少填其中一组」，就得在
parse_args()后手动校验：if not (args.env or args.config) and not (args.debug or args.verbose): raise SystemExit("至少需指定环境或调试模式")
子命令（subparsers）里怎么共享父级参数
子命令默认不继承父解析器的参数，add_subparsers() 的 dest 参数只控制子命令名变量名，不传递选项。
真正共享的方式是：用 add_parser(..., parents=[parent_parser])，但必须确保 parent_parser 的 add_argument() 调用在 add_subparsers() 之前，且不能带 required=True（否则子命令调用时会强制要求该参数，即使它属于父级上下文）。
立即学习“Python免费学习笔记（深入）”；
- 定义父解析器时，所有想共享的参数都设
required=False，哪怕语义上“应该有” - 子解析器创建时显式传入
parents=[parent_parser]，否则参数不会出现 - 注意冲突：如果父级和子级都定义了同名参数（如
--verbose），子级会覆盖父级，且不会报错
ArgumentParser.parse_args() 报错 “unrecognized arguments” 怎么快速定位
这个错误不是参数写错了，而是命令行里出现了 ArgumentParser 完全没声明过的字符串，比如拼错、多空格、或用了未注册的短选项。
最容易被忽略的是：Python 脚本自身接收了 sys.argv 全量，而你调用 parse_args() 时没过滤掉脚本名——但其实 parse_args() 默认就跳过 sys.argv[0]，所以问题通常出在手动传参或测试时。
- 测试时别直接写
parse_args(['--foo', 'bar'])，先检查列表里有没有漏掉的、多余的字符串（比如误加了'script.py'） - 用
parse_known_args()替代，它返回(args, unknown)，能立刻看到哪些被当成未知项 - 如果用了
nargs='*'或nargs='+'，确保后续参数没被其他选项“吃掉”，比如--files a b c --verbose中，--verbose会被当作文本而非选项，除非--files明确结束
怎么让 argparse 输出帮助时不显示默认值，但运行时又实际生效
argparse 默认在 -h 里显示 [default: xxx]，但很多场景下默认值是内部逻辑推导的（比如从环境变量读），不希望暴露给用户，又不能删掉 default=...，否则运行时没默认行为。
关键在 help 字符串里手动控制显示逻辑，而不是依赖自动渲染。
- 把
default设为真实值（比如os.getenv('LOG_LEVEL', 'INFO')），保证运行时有效 - 在
help参数里写死描述，比如help="日志级别，默认由 LOG_LEVEL 环境变量决定"，不写[default: ...] - 绝对不要设
default=argparse.SUPPRESS，它会让参数彻底不存入args对象，导致运行时报AttributeError
argparse 的“高级”往往藏在组合逻辑里：子命令+父参数+互斥组+动态默认值，四者一叠，校验和提示就容易断层。最常漏的是 parse_known_args 的兜底检查，以及 subparsers 下忘了传 parents。这些地方不报错，但行为和预期差很远。
