能否禁止Python ABC的派生类新增额外方法？

可以实现这个需求——相当于abstractmethod的反向约束，限制派生类只能重写基类已有的方法，不能新增自定义方法。下面是具体实现方案：

方法一：自定义元类（推荐） #

通过继承ABCMeta自定义元类，在类创建阶段自动检查派生类的方法集合是否完全包含在基类允许的范围内：

from abc import ABCMeta, abstractmethod

class RestrictedABCMeta(ABCMeta):
    def __new__(cls, name, bases, namespace):
        # 收集所有基类允许的方法（排除大部分特殊方法，保留__init__）
        allowed_methods = set()
        for base in bases:
            # 获取基类的所有方法（包括实例方法、抽象方法）
            base_methods = {
                attr for attr in dir(base) 
                if (callable(getattr(base, attr, None)) or attr in base.__dict__)
            }
            allowed_methods.update(base_methods)
        
        # 过滤特殊方法：只保留__init__，排除其他__xx__形式的系统方法
        allowed_methods = {
            m for m in allowed_methods 
            if not (m.startswith('__') and m.endswith('__')) or m == '__init__'
        }

        # 获取当前类自定义的方法（排除继承来的）
        current_methods = {
            attr for attr in namespace 
            if callable(namespace[attr]) or attr == '__init__'
        }

        # 检查是否有基类未定义的新增方法
        new_methods = current_methods - allowed_methods
        if new_methods:
            raise TypeError(f"派生类 {name} 禁止新增额外方法: {', '.join(new_methods)}")
        
        # 调用父类逻辑创建类
        return super().__new__(cls, name, bases, namespace)

应用到基类 #

修改你的Foo类使用自定义元类：

class Foo(metaclass=RestrictedABCMeta):
    """base class for all Foos"""

    def __init__(self, sec_type: str, metric: str) -> None:
        pass

    def some_base_method(self):
        pass

    @abstractmethod
    def m1(self):
        pass

    @abstractmethod
    def m2(self):
        pass

测试效果 #

• 合法派生类（仅重写/实现基类方法）：

class Bar(Foo):
    def some_base_method(self):
        # 重写基类方法，允许
        pass
    
    def m1(self):
        pass

    def m2(self):
        pass

这个类可以正常创建，不会报错。

• 非法派生类（新增额外方法）：

class NoBueno(Foo):
    def m1(self):
        pass
    def m2(self):
        pass
    def m3(self):
        pass

创建时会直接抛出错误：TypeError: 派生类 NoBueno 禁止新增额外方法: m3

方法二：类装饰器 #

如果不想修改元类，也可以用装饰器手动检查每个派生类：

def restrict_to_base_methods(base_class):
    def decorator(cls):
        # 收集基类允许的方法
        allowed_methods = {
            m for m in dir(base_class) 
            if not (m.startswith('__') and m.endswith('__')) or m == '__init__'
        }
        # 获取当前类自定义的方法
        current_methods = {
            attr for attr in cls.__dict__ 
            if callable(cls.__dict__[attr]) or attr == '__init__'
        }
        # 检查新增方法
        new_methods = current_methods - allowed_methods
        if new_methods:
            raise TypeError(f"派生类 {cls.__name__} 禁止新增额外方法: {', '.join(new_methods)}")
        return cls
    return decorator

使用方式 #

@restrict_to_base_methods(Foo)
class NoBueno(Foo):
    def m1(self):
        pass
    def m2(self):
        pass
    def m3(self):
        pass  # 这里会触发报错

注意事项 #

• 特殊方法：上述代码默认保留了__init__，如果需要允许其他特殊方法（比如__str__），可以修改过滤条件，把需要的方法加入白名单。
• 类方法/静态方法：元类方案会自动包含基类的类方法和静态方法，派生类可以重写但不能新增。
• 继承链：如果基类本身继承了其他类，元类会自动收集所有上层基类的方法，确保派生类只能使用这些方法。

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