如何让argparse未传命令行参数时使用被调用函数的默认值

核心逻辑是：仅将用户在命令行明确传入的参数传递给目标函数，未传入的参数不做显式传值，自动触发函数自身的默认值逻辑，全程不需要硬编码函数默认值到argparse配置中，也不需要为每个参数写单独的分支判断。

通用实现（任意数量参数都适用） #

1. 配置argparse时，将所有可选参数的默认值设为专属标记值（业务允许传None时也可以直接用None，否则用自定义哨兵避免冲突）
2. 参数解析完成后，过滤掉所有等于标记值的项——这些就是用户未主动传入的参数
3. 将过滤后的参数字典拆包传给目标函数即可，未传的项会自动使用函数定义的默认值

参考实现代码：

import argparse

# 自定义哨兵值，不会和用户可能传入的任何合法值冲突
_UNSET = object()

# 不可修改的外部函数
def foreign_func(fav_color="blue"):
    print(fav_color)

clparser = argparse.ArgumentParser()
# add_argument时通过dest指定参数对应的函数形参名，保持命名一致即可
clparser.add_argument(
    "--color",
    dest="fav_color",
    default=_UNSET,
    help="Enter color"
)
clargs = clparser.parse_args()

# 过滤掉用户未明确传入的参数
valid_args = {
    param_name: val
    for param_name, val in vars(clargs).items()
    if val is not _UNSET
}

# 直接拆包传参
foreign_func(**valid_args)

运行效果验证 #

执行python my_prog.py --color=red：valid_args值为{"fav_color": "red"}，函数输出red
执行python my_prog.py不带参数：valid_args为空字典，函数自动使用默认值fav_color="blue"，输出blue

适配场景扩展 #

命令行参数名和函数形参名不一致 #

如果不想通过dest对齐命名，可以加一层简单的映射表，不需要改动核心过滤逻辑：

# 配置命令行参数名到函数形参名的映射关系
ARG_TO_PARAM_MAP = {
    "color": "fav_color"  # 命令行--color对应函数的fav_color形参
}

clparser.add_argument("--color", default=_UNSET, help="Enter color")
clargs = clparser.parse_args()

valid_args = {}
for arg_name, val in vars(clargs).items():
    if val is _UNSET:
        continue
    param_name = ARG_TO_PARAM_MAP.get(arg_name, arg_name)
    valid_args[param_name] = val

foreign_func(**valid_args)

多函数/多参数场景 #

这套过滤逻辑可以抽成通用工具函数，不管后续加多少命令行参数、对接多少外部函数，都不需要重复写参数判断逻辑，完全符合DRY原则：

• 不需要把外部函数的默认值硬编码到argparse的default配置中，后续外部函数修改默认值时，命令行解析逻辑不需要做任何同步修改
• 不需要为每个参数写if xxx is not None的分支判断，新增参数只需要加一行add_argument配置即可

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