必须用add_subparsers()而非嵌套argumentparser：仅用一个顶层解析器，调add_subparsers(dest="command")获取子命令容器，再为各子命令调add_parser()并独立添加参数；子命令逻辑需通过args.command显式路由，不可依赖自动调用。
子命令结构必须用 add_subparsers() 而非嵌套 ArgumentParser
很多人试图手动创建多个独立的 ArgumentParser 实例，再根据主命令分发逻辑——这会导致帮助信息混乱、参数冲突、--help 行为异常。正确做法是只用一个顶层 ArgumentParser，调用其 add_subparsers() 获取子命令容器，再对每个子命令调用 add_parser()。
关键点：
-
add_subparsers()必须传dest参数（如dest="command"），否则解析后无法区分用户选了哪个子命令 - 每个子解析器（如
subparsers.add_parser("build")）返回的是独立ArgumentParser对象，可自由添加自己的add_argument() - 子解析器默认不继承父解析器的参数；若需共享（如全局
--verbose），得在顶层加，并在parse_args()后手动传递或用set_defaults()
parse_args() 返回对象必须检查 command 属性才能路由
argparse 不会自动调用对应函数——它只负责把命令行映射成命名空间对象。你得显式判断 args.command 的值，再分发到处理函数。
常见错误：
- 忘记检查
args.command is None：当用户只运行主命令（如mytool）没给子命令时，args.command是None，直接访问会报AttributeError - 把子命令逻辑写在
add_parser()调用里：比如subparsers.add_parser("deploy").set_defaults(func=deploy)是可行的，但若后续要传额外上下文（如配置对象），不如统一在主逻辑里if args.command == "deploy": deploy(args) - 子命令参数未设
required=True却又没给默认值：导致parse_args()直接退出并打印帮助，而不是抛异常让你捕获
二级子命令（如 mytool project create）要复用 add_subparsers()
argparse 本身不原生支持“三级”命令，但你可以对一级子命令的解析器再次调用 add_subparsers()。例如 project_parser = subparsers.add_parser("project")，然后 project_sub = project_parser.add_subparsers(dest="project_cmd")。
注意细节：
- 每个层级的
dest名必须唯一，否则会覆盖（如一级用dest="command"，二级就得用dest="project_cmd"） - 帮助信息默认只显示当前层级：运行
mytool project --help不会列出create和delete，除非你在add_subparsers()中加metavar="SUBCOMMAND"并确保子命令有help字符串 - 如果某子命令不需要进一步拆分（如
mytool build），就不要在其解析器上调用add_subparsers()，否则 argparse 会要求你必须提供一个子命令名
避免 TypeError: 'NoneType' object is not callable 错误
这个错误几乎总是因为：某个子命令解析器被创建了，但没设置 func 或对应属性，而你又试图无条件调用 args.func(args)。
安全做法：
- 统一用
getattr(args, "func", lambda a: print("no handler"))(args)，而不是硬写args.func(args) - 或者更明确：在每个子解析器上都调用
set_defaults(func=xxx)，包括占位用的空函数 - 调试时打印
vars(args)，确认command和各层dest对应的字段是否如预期存在且非None
多层级 CLI 的复杂度不在语法，而在参数归属和执行路由的清晰边界。一旦 dest 命名重复、func 没兜底、或帮助信息缺失，用户第一眼就会卡住。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
