如何统一修改继承自同一父类的兄弟类同名方法？解决类型检查警告

我有两个继承自同一父类Widget的子类Table和Button，二者均拥有各自的keyEvent()方法，且会在必要时调用Widget.keyEvent()。我希望以相同方式修改这两个类的keyEvent()行为（例如让A、D键触发LEFT、RIGHT键）。

目前我使用如下代码实现了预期功能：

class KeyModifier:
    def keyEvent():
        # some lines of code
        super().keyEvent()

class MyTable(KeyModifier,Table):
    pass

class MyButton(KeyModifier,Button):
    pass

但Pylance提示错误，原因是KeyModifier的super()没有keyEvent()方法（确实如此）。我想知道是否有更优的实现方式？同时希望Pylance能在将KeyModifier用于非Widget子类时发出警告。

注：此示例来自PyQT应用，但问题具有通用性。
补充说明：若让KeyModifier继承Widget，super().keyEvent()会调用Widget.keyEvent()，而我希望调用的是子类（Table或Button）的keyEvent()方法。

方法一：带类型检查的Mixin类（推荐） #

这种方式保留了多重继承的简洁性，同时解决Pylance类型提示问题，还能限制KeyModifier仅用于Widget子类。

from typing import Protocol, cast
from PyQt5.QtWidgets import QWidget  # 替换为你实际使用的Widget类
from PyQt5.QtGui import QKeyEvent, Qt

# 定义协议，描述拥有keyEvent方法的类接口
class WidgetKeyProtocol(Protocol):
    def keyEvent(self, event: QKeyEvent) -> None:
        ...

class KeyModifier:
    def __init_subclass__(cls) -> None:
        # 检查子类是否继承自Widget（或其子类）
        if not issubclass(cls, QWidget):
            raise TypeError(f"KeyModifier只能用于继承自Widget的类，{cls.__name__}不符合要求")

    def keyEvent(self, event: QKeyEvent) -> None:
        # 自定义按键修改逻辑：将A/D键转换为LEFT/RIGHT键
        if event.key() == Qt.Key_A:
            event = QKeyEvent(
                event.type(), Qt.Key_Left, event.modifiers(),
                event.text(), event.isAutoRepeat(), event.count()
            )
        elif event.key() == Qt.Key_D:
            event = QKeyEvent(
                event.type(), Qt.Key_Right, event.modifiers(),
                event.text(), event.isAutoRepeat(), event.count()
            )
        
        # 通过cast让Pylance识别super()实例拥有keyEvent方法
        super_widget = cast(WidgetKeyProtocol, super())
        super_widget.keyEvent(event)

# 使用示例
class MyTable(KeyModifier, Table):
    pass

class MyButton(KeyModifier, Button):
    pass

原理说明：

• 多重继承的MRO（方法解析顺序）保证KeyModifier.keyEvent执行后，super()会指向Table/Button而非Widget，满足调用子类keyEvent的需求。
• __init_subclass__会在创建子类时立即检查继承合法性，运行时和Pylance都会识别非法继承问题。
• WidgetKeyProtocol和cast消除了Pylance对super().keyEvent()的类型报错。

方法二：类装饰器 #

如果偏好避免多重继承，可用装饰器统一修改类的keyEvent方法，同时实现类型检查：

from PyQt5.QtWidgets import QWidget
from PyQt5.QtGui import QKeyEvent, Qt

def modify_key_event(cls):
    # 检查是否为Widget子类
    if not issubclass(cls, QWidget):
        raise TypeError("此装饰器只能应用于Widget的子类")
    
    original_key_event = cls.keyEvent
    def new_key_event(self, event: QKeyEvent) -> None:
        # 自定义按键修改逻辑
        if event.key() == Qt.Key_A:
            event = QKeyEvent(
                event.type(), Qt.Key_Left, event.modifiers(),
                event.text(), event.isAutoRepeat(), event.count()
            )
        elif event.key() == Qt.Key_D:
            event = QKeyEvent(
                event.type(), Qt.Key_Right, event.modifiers(),
                event.text(), event.isAutoRepeat(), event.count()
            )
        original_key_event(self, event)
    
    cls.keyEvent = new_key_event
    return cls

# 使用示例
@modify_key_event
class MyTable(Table):
    pass

@modify_key_event
class MyButton(Button):
    pass

优缺点：

• 优点：避免多重继承，逻辑直观。
• 缺点：若子类后续重写keyEvent，会覆盖装饰后的方法，需额外注意。

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