Python如何创建带抽象__init__方法的类满足三项接口设计要求

不需要把__init__标记为抽象方法就能覆盖所有诉求，核心思路是：抽象基类仅对实例层面的方法做强制抽象约束，构造方法的契约通过基类文档+可正常调用的基类__init__实现来约定，既保留完整的接口文档可读性，又保证super调用链安全，同时不限制子类扩展构造参数、也不影响类本身作为可调用对象使用。

实现代码 #

from abc import ABC, abstractmethod
from typing import Type, Callable


class AbstractAlgorithm(ABC):
    """
    算法抽象接口，所有实现类需遵守以下契约：
    1. 构造方法必须接收1个int类型的入参`param`作为初始化参数，可按需扩展自定义参数
    2. 必须实现`get_result`方法，返回int类型的算法计算结果
    """
    def __init__(self, param: int):
        """
        基类初始化方法，子类重写构造方法时必须调用`super().__init__(param)`，保证多继承场景下的协作式调用链正常
        :param param: 算法初始化核心参数
        """
        # 基类初始化逻辑为空，仅用于承接super调用，不强制约束业务逻辑
        pass

    @abstractmethod
    def get_result(self) -> int:
        """执行算法计算，返回整数结果"""
        pass


class ConcreteAlgorithm(AbstractAlgorithm):
    def __init__(self, param: int, enable_double: bool = True):
        # 按约定调用基类构造方法，子类可自由扩展额外参数
        super().__init__(param)
        self._param = param
        self._enable_double = enable_double

    def get_result(self) -> int:
        return self._param * 2 if self._enable_double else self._param


# 类型标注：既支持传入AbstractAlgorithm的子类，也支持传入符合签名要求的任意可调用对象
AlgorithmConstructor = Type[AbstractAlgorithm] | Callable[[int], AbstractAlgorithm]


def use_algorithm(algorithm: AlgorithmConstructor) -> int:
    instance = algorithm(10)
    # 可选运行时校验，避免非法可调用对象返回不符合契约的实例
    if not isinstance(instance, AbstractAlgorithm):
        raise TypeError("传入的构造器返回值不符合AbstractAlgorithm接口规范")
    return instance.get_result()


if __name__ == "__main__":
    # 直接传入具体类作为可调用对象
    print(use_algorithm(ConcreteAlgorithm))
    # 支持传入自定义工厂函数，保留动态选择算法的灵活性
    def dynamic_algorithm(param: int) -> AbstractAlgorithm:
        class TempAlgo(AbstractAlgorithm):
            def get_result(self) -> int:
                return param + 100
        return TempAlgo()
    print(use_algorithm(dynamic_algorithm))

方案符合要求的说明 #

• 接口文档完整性：抽象基类的类说明、__init__方法签名和文档、get_result抽象方法的签名和文档都完整保留，自动文档生成工具、类型检查器、代码阅读者都能直接从基类获取全部接口规则。
• 可调用特性保留：具体实现类不需要额外包装工厂方法，可以直接作为可调用对象传入使用，同时兼容传入普通函数作为动态构造器，不损失原有灵活性。
• super调用安全：基类的__init__有明确的非抽象实现，子类重写构造方法时只要按约定传入核心参数param即可正常完成super调用，多继承场景下的协作逻辑完全不会被破坏，也不限制子类扩展自定义构造参数。

补充说明 #

此前方案的核心问题是错误地将__init__标记为了@abstractmethod：抽象基类的抽象方法约束的是实例必须实现的方法，而构造方法是类层面的可调用行为，不需要通过抽象标记来强制。如果子类构造方法不符合签名要求，在实例化阶段就会抛出参数不匹配的错误，配合可选的运行时实例校验，完全可以保证接口契约不被破坏。

内容的提问来源于stack exchange，提问作者Björn Pollex