argparse子命令必须用add_subparsers()显式创建，否则参数被丢弃或报错；因其建立独立解析上下文，未调用则主解析器无法识别子命令，导致unrecognized arguments等错误。
argparse 支持子命令，但必须用 add_subparsers() 显式创建，否则所有参数都会被丢弃或报错。
为什么直接在主 parser 上加参数会失效？
子命令不是“可选参数”，而是独立的解析上下文。一旦调用 add_subparsers()，argparse 就会把后续参数按子命令分流；如果没调用它，哪怕写了 subparsers.add_parser('build')，主 parser 也根本不知道该把 build --target lib 交给谁处理。
- 常见错误现象：
error: unrecognized arguments: build或error: too few arguments，即使子命令明明存在 - 关键点：
add_subparsers()返回的是一个ArgumentParser子解析器对象，必须赋值给变量（如subparsers），再在其上调用add_parser() - 容易忽略：默认情况下
add_subparsers()的dest参数为空，导致args中没有字段标识当前子命令名——建议显式设为dest='command'
如何让子命令共享通用参数（比如 --verbose）？
不能靠主 parser 加参数，因为子命令解析时会跳过主 parser 的规则。正确做法是定义父 parser，再传给每个子命令。
- 先用
ArgumentParser(add_help=False)创建父 parser，加上add_argument('--verbose', ...) - 每个
subparsers.add_parser(..., parents=[parent_parser])，这样子命令自动继承该参数 - 注意：
parents不继承 help 文本里的描述位置，但参数行为和类型校验完全一致 - 性能无影响，只是参数定义复用，不增加运行时开销
子命令函数怎么和 argparse 绑定？
argparse 不执行函数，只解析成 args 对象。绑定靠 set_defaults() 设置回调函数，再手动触发。
- 每个子命令 parser 调用
set_defaults(func=build_handler)，其中build_handler是普通函数 - 解析后检查
if hasattr(args, 'func') and args.func:，然后args.func(args) - 别写成
set_defaults(func=build_handler())—— 这会立即执行，不是绑定 - 错误示例：
parser.set_defaults(func=lambda: print("run"))看似简洁，但无法传参、难调试，也不支持类型提示
如何避免子命令间参数名冲突？
argparse 默认允许不同子命令用相同参数名（如都叫 --output），但值会覆盖——后解析的子命令参数会覆盖前面的，导致逻辑混乱。
- 解决办法：每个子命令 parser 独立定义参数，不要依赖主 parser 或全局命名空间
- 推荐命名习惯：子命令级参数加前缀，比如
build用--build-output，test用--test-coverage，避免歧义 - 兼容性注意：Python 3.7+ 的
add_subparsers(required=True)可防止用户不输子命令就运行，3.6 及更早需手动检查args.command is None
最易被忽略的是 add_subparsers() 的返回值必须保存并用于后续 add_parser()，而不是当成一次性调用；还有就是 set_defaults(func=...) 后忘记在主逻辑里调用 args.func(args)，结果解析成功却什么也不做。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
