必须先调用add_subparsers()初始化子命令结构，否则会报AttributeError；返回SubParsersAction对象，子命令需通过它添加；需显式指定required=True，否则Python 3.7+下不输子命令将静默失败。
子命令结构必须用 add_subparsers() 初始化
不调用 add_subparsers() 就直接加子命令，会报 AttributeError: 'ArgumentParser' object has no attribute 'add_parser'。它返回的是一个 SubParsersAction 对象，后续所有子命令都得通过它添加，不是在主 parser 上调用 add_parser()。
常见错误是漏掉 required=True（Python 3.7+ 默认为 False），导致用户不输子命令也不报错，而是静默进入空解析状态，最后 args 里连 subcommand 属性都没有。
subparsers = parser.add_subparsers(dest="subcommand", required=True)- 如果兼容旧版 Python（required=True 显式声明；否则要手动检查
args.subcommand is None -
dest参数名就是将来从args中取子命令名称的键名，别写错
每个子命令需独立调用 add_parser() 并设置 set_defaults()
子命令不是“配置项”，而是独立的解析上下文。每个 add_parser("xxx") 返回一个新的 ArgumentParser 实例，它继承主 parser 的描述等基础信息，但参数、帮助文本、默认行为全得单独定义。
最关键的是：必须用 set_defaults(func=xxx) 绑定执行函数，否则解析完无法知道该调哪个逻辑。这个 func 不是 argparse 内置关键字，是你自己约定的字段名，和前面 dest="subcommand" 是解耦的。
立即学习“Python免费学习笔记（深入）”；
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
ls_parser = subparsers.add_parser("ls", help="List files")ls_parser.add_argument("--long", "-l", action="store_true")-
ls_parser.set_defaults(func=handle_ls)—— 这行不能少 - 多个子命令可以共用同一个处理函数，只要在函数内部用
args.subcommand分支即可
执行时先解析再调用 args.func()，别忘了传 args
argparse 不会自动执行函数，它只负责把命令行映射成 Namespace 对象。你得手动触发：拿到 args 后，检查 hasattr(args, "func")（更稳妥）或直接 args.func(args)。
容易踩的坑是忘记把 args 传进去，导致处理函数收不到参数；或者没做存在性判断就硬调 args.func，遇到无子命令输入时崩掉（即使设了 required=True，某些异常路径下仍可能为空）。
args = parser.parse_args()if hasattr(args, "func"):args.func(args)- 处理函数签名建议统一为
def handle_xxx(args):，方便复用和测试
help 信息重复和子命令嵌套的现实约束
argparse 原生不支持子命令嵌套（比如 git remote add 这种两级命令）。所谓“嵌套”其实是靠多层 add_subparsers() 模拟，但第二级 help 会丢失顶层上下文，用户运行 prog remote --help 看不到 prog 的全局说明。
另外，每个子命令的 help 字符串会出现在主 help 的子命令列表里，但如果子命令本身也调用了 add_subparsers()，它的子命令不会自动汇总到上级 help 中——得手动维护或用第三方库（如 argcomplete 或自定义 formatter）。
- 避免深度嵌套；三层以上基本失去可维护性
- 子命令名别用破折号（
-），虽然技术上可行，但和选项混淆，推荐用下划线或驼峰 - help 文本尽量简短，过长会导致主 help 排版错乱，尤其在终端宽度受限时
set_defaults(func=...) 和调用前的 hasattr 检查——这两处一漏，工具就变成“能解析不能执行”的半成品。 
