如何管理Python函数默认参数？避免重复及支持显式None传参

问题场景 #

有一组互相调用的函数，参数存在重复的默认值，且希望传入None时自动使用默认值：

def f0(..., p1=3, p2=5):
    ...
def f1(..., p1=3, p2=5, p3=8, p4=13):
    ...
    f0(..., p1=p1, p2=p2)
    ...
def f2(..., p1=3, p2=5, p3=8, p4=13, p5=21, p6=123):
    ...
    f1(..., p1=p1, p2=p2, p3=p3, p4=p4)
    ...
def f3(..., p1=3, p2=5, p3=8, p4=13, p5=21, p6=123, ...):
    ...
    f2(..., p1=p1, p2=p2, p3=p3, p4=p4, p5=p5, p6=p6)
    ...

常规写法需要单独定义默认值常量，再在函数里判断None，既繁琐又重复，想要更简洁的Pythonic实现。

解决方案 #

1. 数据类统一管理默认值 #

把所有参数的默认值集中在一个数据类里，配合辅助函数简化None判断，同时保持函数签名的可读性：

from dataclasses import dataclass

@dataclass
class DefaultParams:
    p1: int = 3
    p2: int = 5
    p3: int = 8
    p4: int = 13
    p5: int = 21
    p6: int = 123

def get_param(value, default):
    return value if value is not None else default

def f0(..., p1=None, p2=None):
    defaults = DefaultParams()
    p1 = get_param(p1, defaults.p1)
    p2 = get_param(p2, defaults.p2)
    ...

def f1(..., p1=None, p2=None, p3=None, p4=None):
    defaults = DefaultParams()
    p3 = get_param(p3, defaults.p3)
    p4 = get_param(p4, defaults.p4)
    f0(..., p1=p1, p2=p2)
    ...

def f2(..., p1=None, p2=None, p3=None, p4=None, p5=None, p6=None):
    defaults = DefaultParams()
    p5 = get_param(p5, defaults.p5)
    p6 = get_param(p6, defaults.p6)
    f1(..., p1=p1, p2=p2, p3=p3, p4=p4)
    ...

2. **kwargs + 字典合并简化参数传递 #

利用关键字参数传递，结合默认字典自动覆盖非None的参数，适合参数较多的场景：

DEFAULT_PARAMS = {
    'p1':3, 'p2':5, 'p3':8, 'p4':13, 'p5':21, 'p6':123
}

def f0(..., **kwargs):
    # 过滤None值，合并默认参数
    valid_params = {k:v for k,v in kwargs.items() if v is not None}
    final_params = {**DEFAULT_PARAMS, **valid_params}
    # 使用final_params['p1']、final_params['p2']即可
    ...

def f1(..., **kwargs):
    valid_params = {k:v for k,v in kwargs.items() if v is not None}
    final_params = {**DEFAULT_PARAMS, **valid_params}
    # 传递f0需要的参数
    f0(..., p1=final_params['p1'], p2=final_params['p2'])
    ...

3. 装饰器统一处理None替换 #

写一个装饰器，自动将传入的None参数替换为预设默认值，实现全局统一逻辑：

def with_defaults(defaults):
    def decorator(func):
        def wrapper(*args, **kwargs):
            processed_kwargs = {
                k: v if v is not None else defaults[k]
                for k, v in kwargs.items()
            }
            return func(*args, **processed_kwargs)
        return wrapper
    return decorator

DEFAULT_PARAMS = {'p1':3, 'p2':5, 'p3':8, 'p4':13, 'p5':21, 'p6':123}

@with_defaults(DEFAULT_PARAMS)
def f0(..., p1=3, p2=5):
    ...

@with_defaults(DEFAULT_PARAMS)
def f1(..., p1=3, p2=5, p3=8, p4=13):
    ...
    f0(..., p1=p1, p2=p2)
    ...

总结 #

• 追求可读性和类型提示：优先选择数据类+辅助函数方案
• 参数数量多且灵活：用kwargs+字典合并方案
• 需要统一所有函数的参数处理逻辑：用装饰器方案

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