如何使用argparse解析数量不确定的命名参数？

很棒的问题！可惜argparse原生并不支持你示例里的nargs="**"写法——这个语法其实是无效的。不过别担心，我们有几种靠谱的方法能实现你想要的效果：把任意数量的--key value形式参数解析成字典。

方案一：用parse_known_args处理未知参数 #

这是最贴近你需求的方案：先解析你已知的参数（如果有的话），然后把剩下的未知参数手动转换成字典。

import argparse

# 创建解析器，可以先添加你需要的已知参数
parser = argparse.ArgumentParser()
# parser.add_argument("--some-known-arg")  # 示例已知参数，可根据需求添加

# 解析已知参数，剩下的未知参数存到unknown列表里
args, unknown = parser.parse_known_args(['--foo', 'FOO', '--bar', 'BAR'])

# 把未知参数转换成字典
optionals = {}
i = 0
while i < len(unknown):
    # 处理--开头的键
    if unknown[i].startswith('--'):
        key = unknown[i].lstrip('--')
        # 检查下一项是否是值（不是--开头的参数）
        if i + 1 < len(unknown) and not unknown[i+1].startswith('--'):
            optionals[key] = unknown[i+1]
            i += 2
        else:
            # 处理没有值的flag（比如--verbose），这里设为True，你也可以根据需求调整
            optionals[key] = True
            i += 1
    else:
        # 遇到非--开头的未知参数，这里选择报错，你也可以忽略或其他处理
        raise ValueError(f"Unexpected positional argument: {unknown[i]}")

# 把字典添加到解析结果里
args.optionals = optionals
print(args)
# 输出：Namespace(optionals={'foo': 'FOO', 'bar': 'BAR'})

这个方法灵活度很高，能处理各种边缘情况，比如没有值的标记参数、值包含特殊字符的情况（只要命令行正确传递）。

方案二：自定义Action类（更优雅的封装） #

如果你想把这个逻辑封装成argparse的原生参数形式，可以自定义一个Action类，让它自动收集键值对到字典：

import argparse

class KeyValueDictAction(argparse.Action):
    def __call__(self, parser, namespace, values, option_string=None):
        # 确保目标属性是字典
        if not getattr(namespace, self.dest):
            setattr(namespace, self.dest, {})
        # 每次调用处理一个键值对
        key, value = values
        getattr(namespace, self.dest)[key] = value

parser = argparse.ArgumentParser()
# 添加一个参数，用自定义Action，nargs=2表示每次接受两个值（键和值）
# 用户需要用--opt foo FOO --opt bar BAR这样的形式输入
parser.add_argument('--opt', dest='optionals', action=KeyValueDictAction, nargs=2, default={}, help='Add key-value pairs (e.g., --opt foo FOO)')

args = parser.parse_args(['--opt', 'foo', 'FOO', '--opt', 'bar', 'BAR'])
print(args)
# 输出：Namespace(optionals={'foo': 'FOO', 'bar': 'BAR'})

这个方案更符合argparse的原生使用习惯，但需要用户通过同一个--opt参数来传递所有键值对，而不是直接用--foo、--bar这样的独立参数。

方案三：用key=value格式批量传递 #

如果可以接受用户用key=value的格式输入，还可以用nargs='*'来批量收集，再转换成字典：

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--opts', nargs='*', help='Optional key-value pairs in key=value format (e.g., --opts foo=FOO bar=BAR)')

args = parser.parse_args(['--opts', 'foo=FOO', 'bar=BAR'])

# 把列表转换成字典，split只做一次，避免值里包含=的情况
optionals = {}
for item in args.opts or []:
    key, value = item.split('=', 1)
    optionals[key] = value

args.optionals = optionals
print(args)
# 输出：Namespace(opts=['foo=FOO', 'bar=BAR'], optionals={'foo': 'FOO', 'bar': 'BAR'})

这种方式更规范，用户能明确区分哪些是可变的命名参数，适合需要明确参数边界的场景。

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