如何使用argparse实现类似Git的命令分组功能？

可以实现，argparse原生不支持直接的命令分组，但通过自定义帮助格式化器就能做到Git那样的分组帮助输出。先解决你之前的核心问题：你尝试添加多个子解析器报错，是因为argparse规定一个主解析器只能有一个add_subparsers()实例，不能多次调用，所以直接加多个子解析器会触发cannot have multiple subparser arguments错误。

下面是最规范的实现方案，完全通过argparse的扩展能力实现分组帮助：

方案：自定义帮助格式化器 #

通过继承argparse.HelpFormatter重写帮助文本的生成逻辑，给每个子命令标记分组，然后在帮助中按组展示。

完整代码示例 #

import argparse

class GroupedHelpFormatter(argparse.HelpFormatter):
    def _iter_non_optional_actions(self):
        # 按自定义分组归类子命令
        command_groups = {}
        # 遍历所有动作，筛选出子解析器的命令
        for action in super()._iter_non_optional_actions():
            if isinstance(action, argparse._SubParsersAction):
                # 处理每个子命令
                for sub_cmd_action in action._choices_actions:
                    # 获取命令所属分组，默认归到"其他命令"
                    group_name = sub_cmd_action.metavar.get('help_group', 'Other Commands')
                    if group_name not in command_groups:
                        command_groups[group_name] = []
                    command_groups[group_name].append(sub_cmd_action)
                continue
            # 输出非子解析器的动作（比如全局参数）
            yield action
        
        # 按分组输出命令
        for group, cmds in sorted(command_groups.items()):
            # 添加分组标题
            self._indent()
            self._write_text(f'\n*{group}:*')
            self._dedent()
            # 输出该组下的所有命令
            for cmd in cmds:
                yield cmd

# 创建主解析器，指定自定义格式化器
main_parser = argparse.ArgumentParser(
    description='模拟Git的分组命令行工具',
    formatter_class=GroupedHelpFormatter
)

# 添加唯一的子解析器（这是argparse的要求）
subparsers = main_parser.add_subparsers(dest='command', required=True)

# 按分组添加子命令，通过metavar传递分组标记
# 仓库操作分组
subparsers.add_parser('init', help='初始化新仓库', metavar={'help_group': '仓库操作'})
subparsers.add_parser('clone', help='克隆远程仓库', metavar={'help_group': '仓库操作'})

# 本地修改分组
subparsers.add_parser('add', help='将文件加入暂存区', metavar={'help_group': '本地修改'})
subparsers.add_parser('commit', help='提交暂存区的修改', metavar={'help_group': '本地修改'})

# 远程协作分组
subparsers.add_parser('push', help='推送本地提交到远程', metavar={'help_group': '远程协作'})
subparsers.add_parser('pull', help='拉取远程更新到本地', metavar={'help_group': '远程协作'})

# 解析参数
args = main_parser.parse_args()

效果说明 #

运行脚本时加上-h参数，会得到类似Git的分组帮助输出：

usage: script.py [-h] {init,clone,add,commit,push,pull} ...

模拟Git的分组命令行工具

positional arguments:
  {init,clone,add,commit,push,pull}
                        可用命令

  *仓库操作:*
    init                初始化新仓库
    clone               克隆远程仓库

  *本地修改:*
    add                 将文件加入暂存区
    commit              提交暂存区的修改

  *远程协作:*
    push                推送本地提交到远程
    pull                拉取远程更新到本地

optional arguments:
  -h, --help            show this help message and exit

备选方案：嵌套子解析器（不推荐） #

如果不想自定义格式化器，可以把分组做成嵌套的父命令（比如script.py repo init），但这种方式不符合Git的直接命令风格，仅作为备选思路：

import argparse

main_parser = argparse.ArgumentParser(description='嵌套子解析器示例')
subparsers = main_parser.add_subparsers(dest='group', required=True)

# 仓库操作分组作为父命令
repo_group = subparsers.add_parser('repo', help='仓库操作相关命令')
repo_subparsers = repo_group.add_subparsers(dest='repo_cmd', required=True)
repo_subparsers.add_parser('init', help='初始化仓库')
repo_subparsers.add_parser('clone', help='克隆仓库')

# 本地修改分组作为父命令
change_group = subparsers.add_parser('change', help='本地修改相关命令')
change_subparsers = change_group.add_subparsers(dest='change_cmd', required=True)
change_subparsers.add_parser('add', help='添加文件')
change_subparsers.add_parser('commit', help='提交修改')

args = main_parser.parse_args()

这种方式需要用户输入层级命令，体验不如第一种方案。

内容的提问来源于stack exchange，提问作者BPL