argparse子命令需显式通过add_subparsers的parents参数继承父解析器参数，且父解析器须设add_help=False以避免-h冲突；子命令可覆盖父参数但易引发混淆，漏传parents或配置不当会导致参数丢失、help不显示或默认值未生效。
argparse 子命令如何共享父解析器的通用参数
子命令默认不继承父解析器的 add_argument，必须显式启用继承机制。核心是用 add_subparsers 的 parents 参数传入父解析器，而非靠“自动”或“全局配置”。
必须用 parents 参数显式传递父解析器
父解析器本身不能直接“广播”给所有子命令；每个子命令解析器需单独声明继承关系。常见错误是只定义父解析器却忘了在 add_parser 里指定 parents=[parent_parser]。
-
parent_parser = argparse.ArgumentParser(add_help=False)—— 记得加add_help=False，否则子命令会报重复-h冲突 subparsers = parser.add_subparsers(dest="command")-
subparser_a = subparsers.add_parser("build", parents=[parent_parser])—— 关键：这里传入列表 - 多个父解析器可一起传：
parents=[parent_parser, common_opts]
继承后参数位置与冲突处理
继承来的参数会出现在子命令帮助文本中，但行为和位置受父解析器构造方式影响：
- 父解析器中用
add_argument(..., required=False)的参数，在子命令中仍为可选；required=True会强制该子命令必须提供（除非被子命令自己覆盖） - 如果父解析器用了
nargs="*"或action="append"，子命令调用时行为完全一致 - 子命令可覆盖父参数：例如父定义了
--verbose，子命令再调一次add_argument("--verbose", action="store_true")会覆盖（argparse 允许，但容易引发混淆） - 帮助文本中，父参数会显示在子命令的
optional arguments下，顺序按添加顺序，不受父/子层级影响
常见错误：help 冲突、参数丢失、子命令无响应
这些基本都源于 parents 漏传或父解析器配置不当：
- 报错
argument -h/--help: conflicting option string(s): -h, --help→ 父解析器没设add_help=False - 子命令运行后不报错但父参数值为
None→ 忘记在add_parser中传parents=[...] - 子命令 help 不显示父参数 → 父解析器用了
add_help=True被跳过，或add_parser传了空列表 - 父解析器里用了
set_defaults()，但子命令未触发 → 确保子命令解析器也调用了set_defaults()，或改用add_subparsers(dest=...)后统一处理
真正麻烦的不是写法，而是父子参数作用域混在一起后，dest 名称冲突、默认值覆盖顺序、以及 help 输出逻辑的隐式依赖——这些不会报错，但会让 CLI 行为难以预测。
