子命令注册后不响应是因为add_subparsers()返回值未赋值；必须用subparsers=parser.add_subparsers(dest='command',required=True)保存对象，否则后续add_parser()报AttributeError。
子命令注册后不响应，add_subparsers() 返回值被忽略
调用 add_subparsers() 必须赋值给变量，否则子命令解析器无法挂载。常见错误是写成 parser.add_subparsers() 却没接返回值，导致后续 add_parser() 报 AttributeError: 'NoneType' object has no attribute 'add_parser'。
正确做法是显式保存解析器对象：
subparsers = parser.add_subparsers(dest='command', required=True)
upload_parser = subparsers.add_parser('upload', help='Upload files')
upload_parser.add_argument('--path', required=True)
-
dest='command'是必须的，它指定哪个变量接收子命令名（如'upload'），否则args.command为None -
required=True在 Python 3.7+ 才可用；旧版本需手动检查args.command is None - 每个子解析器应独立调用
add_argument()，父解析器的参数不会自动继承
动态参数依赖子命令类型，但 parse_args() 提前触发校验
比如 deploy 命令需要 --env，而 logs 命令需要 --tail，但若在主解析器上统一加这些参数，就会出现“unrecognized arguments”或必填项误报。
解决方案是分两阶段解析：
立即学习“Python免费学习笔记（深入）”；
- 先用
parse_known_args()获取子命令名，不校验其余参数 - 根据
args.command选择对应子解析器，再用parse_args()精确校验
示例逻辑：
args, remaining = parser.parse_known_args()
if args.command == 'deploy':
deploy_parser = subparsers.choices['deploy']
args = deploy_parser.parse_args(remaining, namespace=args)
注意：不能直接复用 args 对象传入 namespace，需确保该对象有对应属性；更稳妥的方式是新建 argparse.Namespace() 实例。
子命令帮助信息不显示或格式错乱
默认情况下，运行 python cli.py upload -h 可能只显示子命令帮助，但 python cli.py -h 不列出所有子命令——这是因为 add_subparsers() 默认不生成汇总帮助。
修复方式是在创建子解析器时启用 help 参数，并设置 metavar：
subparsers = parser.add_subparsers(
dest='command',
required=True,
help='available commands',
metavar='COMMAND'
)
-
help字符串会出现在父命令的-h输出中，作为子命令总述 -
metavar='COMMAND'让帮助文本显示为usage: cli.py COMMAND [options]，而非难懂的{upload,logs,deploy} - 每个子解析器仍需单独设
help=...，否则其名称不会出现在父帮助里
参数冲突：多个子命令共用同名选项但含义不同
例如 upload --timeout 表示上传超时（秒），而 logs --timeout 表示连接日志服务超时（毫秒）。若都用 type=int，无法区分单位；若都加 help，帮助文本又容易混淆。
推荐做法是用不同参数名 + 别名映射：
- 子命令内使用语义化参数名：
--upload-timeout、--logs-timeout - 或统一用
--timeout，但在各自解析器中加help明确单位，并在业务逻辑里按命令分支处理 - 避免用
add_argument('--timeout', type=int, dest='timeout')跨命令共享dest，会导致值被覆盖
真正麻烦的是当用户输入 cli.py upload --timeout 30 --timeout 60——argparse 默认允许多次，但不会报错合并。需要手动检查 args.timeout 类型是否为 list，再决定取第一个还是报错。
最易被忽略的是子命令解析器的 set_defaults()：它不是给参数设默认值，而是给整个命名空间注入函数或标记，比如 upload_parser.set_defaults(func=do_upload)，后续可直接 args.func(args) 调用，否则就得一堆 if args.command == 'xxx' 分支。
