Python类/方法多属性场景：默认参数与覆写的最优实践

我希望创建带有大量可选默认参数的对象，调用其方法时既能使用默认参数，也能轻松覆写任意参数。目前已有两种实现思路，想了解哪种最符合Python风格：

现有实现方案一：实例属性+显式参数覆写 #

class SimpleInputText:

    def __init__(self, basicFont, **kwargs):
        self._basicFont = basicFont
        self.text = ''
        self.set_defaults(**kwargs)

    def set_defaults(self, **kwargs):
        self.default_text = kwargs.get('default_text', '')
        self.color = kwargs.get('color', (0, 0, 0))
        self.inactive_color = kwargs.get('inactive_color', (50, 50, 50))
        self.error_color = kwargs.get('error_color', None)
        self.background_color = kwargs.get('background_color', None)
        self.border_color = kwargs.get('border_color', (0, 0, 0))
        self.border_size = kwargs.get('border_size', 0)
        self.border_radius = kwargs.get('border_radius', 0)
        self.padding_left = kwargs.get('padding_left', 0)
        self.padding_top = kwargs.get('padding_top', 0)
        self.padding = kwargs.get('padding', 2)
        self.shadow_offset = kwargs.get('shadow_offset', 0)
        self.shadow_color = kwargs.get('shadow_color', (0, 0, 0))
        # (and more possible properties)

    def input_modal(self, x, y, default_text='', color=None, background_color=None,
                    inactive_color=None, border_color=None, border_size=None,
                    border_radius=None, padding_left=None, padding_top=None, padding=None,
                    shadow_offset=None, shadow_color=None, *args, **kwargs ):

        # Set specific values if passed, otherwise use defaults
        color = self.color if color is None else color
        inactive_color = self.inactive_color if inactive_color is None else inactive_color
        error_color = self.error_color if error_color is None else error_color
        background_color = self.background_color if background_color is None else background_color
        border_color = self.border_color if border_color is None else border_color
        border_size = self.border_size if border_size is None else border_size
        padding_left = self.padding_left if padding_left is None else padding_left
        padding_top = self.padding_top if padding_top is None else padding_top
        padding = self.padding if padding is None else padding
        border_radius = self.border_radius if border_radius is None else border_radius
        shadow_offset = self.shadow_offset if shadow_offset is None else shadow_offset
        shadow_color = self.shadow_color if shadow_color is None else shadow_color
        # etc...
        # the method uses, from now on, the local versions of the variables
        # (i.e. color and not self.color) to do its work.

这种方式通过实例属性存储默认值，调用方法时显式判断并覆写参数，能实现需求但代码较为冗长。

现有实现方案二：字典存储默认值+参数合并 #

class SimpleInputText:
    def __init__(self, basicFont, **kwargs):
        self._basicFont = basicFont
        self.text = ''
        # 初始化默认配置字典
        self.defaults = {
            'default_text': '',
            'color': (0, 0, 0),
            'inactive_color': (50, 50, 50),
            'error_color': None,
            # 其他参数...
        }
        # 用传入的kwargs覆盖默认值
        self.defaults.update(kwargs)
    
    def input_modal(self, x, y, default_text='', **kwargs ):
        # 合并实例默认值与方法传入参数
        params = dict(**self.defaults, **kwargs)
        # now use params['color'], params['border_size'], etc in the method

这种方式通过字典存储默认值，合并参数的代码更简洁，但缺少类型提示和IDE自动补全支持。

方案对比与推荐 #

方案一的优缺点 #

• 优点：
  • 代码可读性强，每个参数的来源清晰，IDE能提供自动补全和类型提示，调试时易追踪参数值
  • 适合需要对个别参数做特殊逻辑处理的场景，扩展性好
• 缺点：
  • 参数数量较多时，初始化和方法内的赋值代码会重复冗长，维护成本高

方案二的优缺点 #

• 优点：
  • 代码简洁，避免大量重复的判断赋值语句，新增参数只需修改字典，无需改动方法签名
  • 适配参数数量极多、逻辑统一的场景（如样式配置类）
• 缺点：
  • IDE无法自动补全字典键名，开发者需手动记忆参数名，易出错
  • 缺少类型约束，复杂参数的使用和调试不够直观

更Pythonic的优化方案 #

可以结合两种方案的优点，用**数据类（dataclasses）**实现，兼顾可读性、类型安全和简洁性：

from dataclasses import dataclass, field

@dataclass
class InputConfig:
    default_text: str = ''
    color: tuple[int, int, int] = (0, 0, 0)
    inactive_color: tuple[int, int, int] = (50, 50, 50)
    error_color: tuple[int, int, int] | None = None
    background_color: tuple[int, int, int] | None = None
    border_color: tuple[int, int, int] = (0, 0, 0)
    border_size: int = 0
    border_radius: int = 0
    padding_left: int = 0
    padding_top: int = 0
    padding: int = 2
    shadow_offset: int = 0
    shadow_color: tuple[int, int, int] = (0, 0, 0)

class SimpleInputText:
    def __init__(self, basicFont, **kwargs):
        self._basicFont = basicFont
        self.text = ''
        # 用传入参数覆盖默认配置
        self.config = InputConfig(**kwargs)
    
    def input_modal(self, x, y, **kwargs):
        # 合并实例配置与方法传入参数，生成临时配置对象
        config_dict = {**self.config.__dict__, **kwargs}
        temp_config = InputConfig(**config_dict)
        # 使用temp_config.color、temp_config.border_size等参数进行后续处理

其他优化建议 #

• 对于调用频率高的核心参数（如default_text），可以保留在方法签名中，其余用**kwargs接收，兼顾易用性和简洁性
• 如果需要频繁复用某套参数配置，可使用functools.partial预绑定默认参数，减少重复代码

总结 #

• 若项目注重类型安全、可读性和IDE支持，优先选择方案一或数据类优化版本
• 若参数数量极大，更看重代码简洁性和维护效率，方案二更合适，建议给字典添加类型注释（如dict[str, int | tuple | None]）提升可读性

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