如何在Python中使用参数化Mixin时保留有效的__init__签名？

方案1：使用dataclasses自动生成签名（Python 3.7+） #

利用Python标准库的dataclasses，自动收集所有父类（包括Mixin）的字段生成带明确签名的__init__，通过__post_init__处理Mixin的初始化逻辑，无需手动编写**kwargs。

from dataclasses import dataclass
from inspect import signature

@dataclass
class Base:
    arg1: int

class ParamMixin1:
    arg2: int
    def __post_init__(self):
        # 在这里实现Mixin的初始化逻辑
        pass

class ParamMixin2:
    arg3: int
    def __post_init__(self):
        pass

class NonParamMixin:
    def __post_init__(self):
        # 无参数Mixin仅需实现__post_init__
        pass

@dataclass
class Derived(NonParamMixin, ParamMixin1, ParamMixin2, Base):
    pass

print(signature(Derived.__init__))
# 输出: (self, arg1: int, arg2: int, arg3: int) -> None

方案2：用装饰器动态合并__init__签名 #

编写装饰器遍历类的MRO（方法解析顺序），收集所有父类__init__的参数，生成带完整签名的新__init__方法，兼容原有Mixin的**kwargs写法。

import inspect
from functools import wraps

def merge_init_signatures(cls):
    params = []
    seen_params = set()
    # 遍历MRO收集非重复参数
    for base in cls.__mro__:
        if base is object:
            continue
        try:
            sig = inspect.signature(base.__init__)
            for name, param in sig.parameters.items():
                if name in ('self', 'kwargs'):
                    continue
                if name not in seen_params:
                    seen_params.add(name)
                    params.append(param)
        except ValueError:
            continue
    # 生成新的__init__逻辑
    def new_init(self, **kwargs):
        for base in cls.__mro__[1:]:
            if base is object:
                continue
            base_sig = inspect.signature(base.__init__)
            # 提取当前父类需要的参数
            base_args = {k: v for k, v in kwargs.items() if k in base_sig.parameters}
            base.__init__(self, **base_args)
    # 为新__init__设置正确签名
    new_sig = inspect.signature(new_init).replace(parameters=[
        inspect.Parameter('self', inspect.Parameter.POSITIONAL_OR_KEYWORD),
        *params
    ])
    wraps(cls.__init__, assigned=('__module__', '__name__'))(new_init)
    new_init.__signature__ = new_sig
    cls.__init__ = new_init
    return cls

# 原有类定义保持不变
class Base:
    def __init__(self, arg1):
        self.arg1 = arg1

class ParamMixin1:
    def __init__(self, arg2, **kwargs):
        super().__init__(**kwargs)
        self.arg2 = arg2

class ParamMixin2:
    def __init__(self, arg3, **kwargs):
        super().__init__(**kwargs)
        self.arg3 = arg3

class NonParamMixin:
    def __init__(self, **kwargs):
        super().__init__(**kwargs)

@merge_init_signatures
class Derived(NonParamMixin, ParamMixin1, ParamMixin2, Base):
    pass

print(inspect.signature(Derived.__init__))
# 输出: (self, arg1, arg2, arg3) -> None

方案3：使用attrs库（第三方库，更灵活） #

如果项目允许引入第三方库，attrs比标准库dataclasses支持更多自定义功能（如验证器、转换器），同样能自动合并Mixin字段生成清晰签名。

import attr
from inspect import signature

@attr.s(auto_attribs=True)
class Base:
    arg1: int

class ParamMixin1:
    arg2: int = attr.ib()
    def __attrs_post_init__(self):
        pass

class ParamMixin2:
    arg3: int = attr.ib()
    def __attrs_post_init__(self):
        pass

class NonParamMixin:
    def __attrs_post_init__(self):
        pass

@attr.s(auto_attribs=True)
class Derived(NonParamMixin, ParamMixin1, ParamMixin2, Base):
    pass

print(signature(Derived.__init__))
# 输出: (self, arg1: int, arg2: int, arg3: int) -> None

方案4：类型检查友好的ParamSpec标注（Python 3.10+） #

若仅需满足类型检查（如mypy），无需修改运行时签名，可使用ParamSpec标注Mixin的__init__，让类型检查工具识别所有必要参数。

from typing import TypeVar, ParamSpec
from inspect import signature

P = ParamSpec('P')
T = TypeVar('T')

class Base:
    def __init__(self, arg1: int) -> None:
        self.arg1 = arg1

class ParamMixin1:
    def __init__(self, arg2: int, *args: P.args, **kwargs: P.kwargs) -> None:
        super().__init__(*args, **kwargs)
        self.arg2 = arg2

class ParamMixin2:
    def __init__(self, arg3: int, *args: P.args, **kwargs: P.kwargs) -> None:
        super().__init__(*args, **kwargs)
        self.arg3 = arg3

class NonParamMixin:
    def __init__(self, *args: P.args, **kwargs: P.kwargs) -> None:
        super().__init__(*args, **kwargs)

class Derived(NonParamMixin, ParamMixin1, ParamMixin2, Base):
    pass

# 运行时签名仍为(self, **kwargs)，但mypy会检查arg1、arg2、arg3是否齐全
print(signature(Derived.__init__))

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