如何通过Python类继承使类与实例呈现一致接口？

当然可行！类继承（或Mixin模式）完全是解决你这个问题的合适方案，我们只需要做一点小设计，就能把重复代码抽离到公共父类里，同时保持原有类方法、实例方法的调用方式，还能让mypy顺利进行类型检查。

核心思路 #

把两个match方法里的重复逻辑抽成一个公共的实现方法，然后让子类的类方法/实例方法分别转发调用这个公共方法——公共方法不绑定cls或self，而是接受一个“主体”参数（可以是类本身，也可以是实例对象），这样就能统一处理两种场景的逻辑。

同时，我们可以用Protocol来定义一个通用接口，让mypy识别这两个类都具备match方法，避免类型报错。

具体实现代码 #

首先定义公共的Mixin和类型协议：

from typing import Protocol, Any
from abc import ABC

# 定义Protocol，让mypy识别符合该接口的类/实例
class Matchable(Protocol):
    def match(self, **kwargs: Any) -> Any: ...

class MatchBase(ABC):
    @staticmethod
    def _match_common(subject: Any, **kwargs: Any) -> Any:
        # 这里放两个match方法中重复的核心逻辑
        # 示例逻辑：检查subject的某个属性是否在kwargs的值中
        if hasattr(subject, "target_attr"):
            return subject.target_attr in kwargs.values()
        return False

然后实现第一个以类形式使用的子类：

class ClassDesignedToBeUsedAsClass(MatchBase):
    target_attr = "class_specific_value"

    @classmethod
    def match(cls, **kwargs: Any) -> Any:
        # 类方法转发，把cls作为主体传给公共逻辑
        return cls._match_common(cls, **kwargs)

再实现第二个以实例形式使用的子类：

class ClassDesignedToBeUsedAsInstance(MatchBase):
    def __init__(self, instance_value: str):
        self.target_attr = instance_value

    def match(self, **kwargs: Any) -> Any:
        # 实例方法转发，把self作为主体传给公共逻辑
        return self._match_common(self, **kwargs)

使用效果（和原有代码完全兼容） #

# 保持你原来的调用方式不变
thing1 = ClassDesignedToBeUsedAsClass
thing2 = ClassDesignedToBeUsedAsInstance("instance_specific_value")

test_kwargs = {"key": "class_specific_value"}
for thing in [thing1, thing2]:
    # mypy会识别thing符合Matchable接口，不会报类型错误
    result = thing.match(**test_kwargs)
    print(result)  # 第一个输出True，第二个输出False

为什么这个方案可行？ #

1. 代码复用：所有重复的逻辑都集中在_match_common里，子类只需要做简单的转发，彻底实现DRY原则。
2. 兼容原有API：两个子类的调用方式和你原来的代码完全一致，不需要修改任何调用处的代码。
3. 类型检查友好：通过Matchable Protocol，mypy能正确识别thing1和thing2都具备match方法，不会出现类型不兼容的报错。
4. 灵活性高：如果后续需要修改核心逻辑，只需要改动_match_common一处即可，所有子类都会同步更新。

补充说明 #

如果你的核心逻辑需要区分是类还是实例（比如某些属性在类上和实例上的处理方式不同），可以在_match_common里通过isinstance(subject, type)来判断：

@staticmethod
def _match_common(subject: Any, **kwargs: Any) -> Any:
    if isinstance(subject, type):
        # 处理类主体的逻辑
        pass
    else:
        # 处理实例主体的逻辑
        pass

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