argparse中nargs='+'未生效default：是预期行为还是bug？

在使用argparse定义位置参数时，设置default后出现了不一致的行为：

• 当nargs='*'时，未提供位置参数会自动使用设置的默认值，符合预期
• 当nargs='+'时，未提供位置参数会直接报错，即便帮助信息里正确显示了默认值

请问这是我的预期错误，还是argparse存在bug或不一致性？

测试代码 #

import argparse

for narg in '*+':
    parser = argparse.ArgumentParser(description=f'test nargs {narg}')
    parser.add_argument(
        'dir',
        nargs=narg,
        default=['dir_a', 'dir_b'],
        help='provide directories as arguments (default: %(default)s)',
    )
    try:
        args = parser.parse_args(['-h'])
    except SystemExit:
        pass 
    args = parser.parse_args([])
    print(f'>>>>> args {args}\n')

测试输出 #

usage: testnargs.py [-h] [dir ...]

test nargs *

positional arguments:
  dir         provide directories as arguments (default: ['dir_a', 'dir_b'])

options:
  -h, --help  show this help message and exit
>>>>> args Namespace(dir=['dir_a', 'dir_b'])

usage: testnargs.py [-h] dir [dir ...]

test nargs +

positional arguments:
  dir         provide directories as arguments (default: ['dir_a', 'dir_b'])

options:
  -h, --help  show this help message and exit
usage: testnargs.py [-h] dir [dir ...]
testnargs.py: error: the following arguments are required: dir

运行环境：Python 3.10.5（MacOS），实际场景中程序从可选配置文件读取默认值，目前暂用nargs='*'替代，但需要额外校验参数非空，较为繁琐。

解答 #

这是argparse的预期行为，并非bug或不一致性。

核心原因在于两种nargs的定义逻辑：

• nargs='*'：表示接受零个或多个位置参数，当未提供任何参数时，会正常 fallback 到设置的default值
• nargs='+'：表示接受至少一个位置参数，它的优先级逻辑是「先检查参数是否存在」，如果未提供任何参数，直接判定为参数缺失并抛出错误，不会去读取default值

至于帮助信息里显示default，是argparse的统一展示逻辑——只要参数设置了default就会显示，但实际是否启用该默认值，完全遵循nargs的规则。

替代方案 #

如果需要实现「允许不提供参数时用默认值，提供参数时至少一个」的需求，可以选择两种方式：

1. 继续使用nargs='*'，在解析完成后自行添加校验逻辑，确保参数列表非空
2. 将该参数改为可选参数（添加--前缀），搭配nargs='+'和default，此时未提供参数会使用默认值，提供参数时要求至少一个，示例代码如下：

import argparse
parser = argparse.ArgumentParser()
parser.add_argument(
    '--dir',
    nargs='+',
    default=['dir_a', 'dir_b'],
    help='provide directories as arguments (default: %(default)s)'
)
args = parser.parse_args([])
print(args)  # 输出: Namespace(dir=['dir_a', 'dir_b'])
args = parser.parse_args(['--dir', 'test'])
print(args)  # 输出: Namespace(dir=['test'])

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