Python中用更特化签名重写抽象方法是否为良好实践？

在Python 3中，我可以定义一个包含抽象方法的类，并在派生类中使用更特化的签名实现该方法。我知道这样代码可以运行，但正如许多编程语言中的情况一样，这可能并非良好实践。那么这种做法到底是否可取？

from abc import ABC, abstractmethod

class Base(ABC):
    @abstractmethod
    def foo(self, *args, **kwargs):
        raise NotImplementedError()

class Derived(Base):
    def foo(self, a, b, *args, **kwargs):
        print(f"Derived.foo(a={a}, b={b}, args={args}, kwargs={kwargs})")

d = Derived()
d.foo(1, 2, 3, "bar", baz="baz")

# output:
# Derived.foo(a=1, b=2, args=(3, 'bar'), kwargs={'baz': 'baz'})

补充场景说明 #

我定义了一个包含抽象方法的接口，该方法会返回某种句柄（handle）。特化的实现必须始终能在无额外参数调用时返回默认句柄，但也可以定义特定标志来根据调用方的用例调整句柄。在此场景中，调用方同时也是特化实现的实例化者，了解这些标志。仅基于接口或句柄运行的通用代码无需知晓这些标志。

from abc import ABC, abstractmethod

class Manager(ABC):
    @abstractmethod
    def connect(self, *args, **kwargs):
        raise NotImplementedError()

class DefaultManager(Manager):
    def connect(self, *, thread_safe: bool = False):
        if thread_safe:
            return ThreadSafeHandle()
        else:
            return DefaultHandle()

在我的特定用例中，Manager的实现可能需要根据调用方的用例提供不同的句柄实现。Manager在代码中统一定义，调用方对其使用可能有也可能没有特化需求，例如示例中的线程安全需求。

结论：这种做法在你的特定场景下是可接受的，但需注意边界 #

• 符合核心设计原则
  你的派生类实现满足了抽象接口的基础约定：无参数调用时能返回默认句柄。通用代码仅依赖Manager接口调用connect()时，所有派生类都能正常工作，不会出现兼容性问题，这是面向接口编程的核心要求。

• 特化参数的合理性
  由于调用方同时是派生类的实例化者，清楚特化参数的存在，这种设计相当于给“知情调用者”提供了额外的配置能力，而不会影响只依赖通用接口的代码。这种模式在Python生态中很常见，比如标准库中很多类的方法会在基础接口外提供可选的特化参数。

• 需要规避的风险

  • 绝对不能让特化参数变成必填项：如果派生类的connect()出现必填的新参数，会直接破坏接口兼容性，导致通用代码调用失败。你的示例中使用默认参数的做法，很好地避免了这个问题。
  • 文档要明确：在抽象类的文档中说明“派生类可提供额外可选参数以支持特化需求”，同时在派生类方法文档里清晰标注这些参数的作用，避免其他开发者误用。
  • 类型检查适配：如果使用mypy等工具做类型检查，需要确保抽象方法的签名能覆盖派生类的情况，或者通过@override装饰器明确标注，避免不必要的类型报错。

总的来说，只要保证派生类始终兼容抽象接口的基础调用方式，且特化参数为可选配置，这种做法就是合理的，属于Python动态特性下的实用设计。

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