Python类中多个方法存在重复默认参数，如何更优雅实现？

逐方法硬编码重复默认值的写法维护成本很高，后续要改默认值得逐个方法修改，容易漏改出问题，下面几种方案都能完全保留单次调用传参的灵活性（比如调用f2时单独指定lvl=1的需求完全支持），同时避免重复代码：

方案1：类级常量统一管理（最推荐，可读性最高） #

• 把三个公共参数的默认值统一定义为类的私有常量，所有方法用None作为参数占位默认值，方法内部判断：如果调用时没传对应参数，就取类级默认值，传了就用传入值。
• 优势：逻辑直白无额外抽象，后续要调整全局默认值只需要修改类常量这一处，不会出现默认值不同步的问题。

class Test:
    # 所有公共参数默认值统一在这里维护
    _DEFAULT_VERBOSE = True
    _DEFAULT_DELIM = '\t'
    _DEFAULT_LVL = 0

    def f1(self, a, b, verbose=None, delim=None, lvl=None):
        verbose = self._DEFAULT_VERBOSE if verbose is None else verbose
        delim = self._DEFAULT_DELIM if delim is None else delim
        lvl = self._DEFAULT_LVL if lvl is None else lvl
        # 原有业务逻辑
        ...

    def f2(self, c, verbose=None, delim=None, lvl=None):
        verbose = self._DEFAULT_VERBOSE if verbose is None else verbose
        delim = self._DEFAULT_DELIM if delim is None else delim
        lvl = self._DEFAULT_LVL if lvl is None else lvl
        # 原有业务逻辑
        ...

    def f3(self, d, e, f, verbose=None, delim=None, lvl=None):
        verbose = self._DEFAULT_VERBOSE if verbose is None else verbose
        delim = self._DEFAULT_DELIM if delim is None else delim
        lvl = self._DEFAULT_LVL if lvl is None else lvl
        # 原有业务逻辑
        ...

避坑提醒：不要直接把类属性写在方法参数的默认值位置，Python函数默认值在类定义阶段就会完成求值，后续修改类属性不会同步更新方法的默认参数，用None做哨兵值在方法内判断赋值才是正确写法。

方案2：装饰器统一注入参数（适合方法数量多的场景） #

• 如果类里有大量方法需要这三个公共参数，可以写一个轻量装饰器自动给方法注入公共参数和默认值，新增方法只要加一行装饰器即可，连参数定义和默认值判断的重复代码都能省掉。

import functools

def common_params(func):
    @functools.wraps(func)
    def wrapper(self, *args, verbose=True, delim='\t', lvl=0, **kwargs):
        return func(self, *args, verbose=verbose, delim=delim, lvl=lvl, **kwargs)
    return wrapper

class Test:
    @common_params
    def f1(self, a, b, verbose, delim, lvl):
        # 方法内直接使用三个参数即可，不需要处理默认值
        ...

    @common_params
    def f2(self, c, verbose, delim, lvl):
        # 完全支持自定义传参，比如Test().f2("xxx", lvl=1)
        ...

    @common_params
    def f3(self, d, e, f, verbose, delim, lvl):
        ...

如果需要统一管理默认值，可以把默认值移到类属性里，装饰器内通过self读取类属性即可，不需要在装饰器里硬编码。

方案3：实例属性存默认值（适合实例级配置场景） #

• 如果这三个参数本身属于实例的全局配置（不同实例可能需要不同的默认值），可以把默认值放到实例初始化方法里定义，单次调用传参就覆盖实例默认，不传就用实例配置。

class Test:
    def __init__(self, verbose=True, delim='\t', lvl=0):
        # 实例化时可以配置该实例的全局默认参数
        self.verbose = verbose
        self.delim = delim
        self.lvl = lvl

    def f1(self, a, b, verbose=None, delim=None, lvl=None):
        verbose = self.verbose if verbose is None else verbose
        delim = self.delim if delim is None else delim
        lvl = self.lvl if lvl is None else lvl
        ...

    def f2(self, c, verbose=None, delim=None, lvl=None):
        verbose = self.verbose if verbose is None else verbose
        delim = self.delim if delim is None else delim
        lvl = self.lvl if lvl is None else lvl
        ...

选型建议 #

• 只是想消除硬编码重复、默认值全局固定，选方案1，维护成本最低，新人接手也能一眼看懂逻辑。
• 类中需要带公共参数的方法超过5个，选方案2，代码最简洁。
• 不同实例需要不同的默认配置，选方案3，最符合面向对象设计逻辑。

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