为何PyQt代码中mypy报edit方法与父类签名不兼容错误？

mypy报错的核心原因是：父类QAbstractItemView的edit方法有两个重载版本，子类必须覆盖所有重载签名，或者提供一个能兼容所有父类调用场景的实现。

你只实现了父类的第二个重载（三个参数、返回bool），但父类还有一个单参数的重载（仅传index、返回None）。当代码尝试调用子类实例的edit(index)时，子类没有对应的实现，mypy会判定子类的方法签名与父类不兼容——因为父类对外暴露的调用接口在子类中被“截断”了一部分。

解决方法 #

方法1：显式实现所有父类重载版本 #

在子类中分别实现两个重载方法，单参数版本直接调用父类实现：

from PyQt6.QtWidgets import QTableView, QAbstractItemView, QModelIndex
from PyQt6.QtCore import QEvent, Optional

class MyTableView(QTableView):
    def edit(self, index: QModelIndex) -> None:
        super().edit(index)

    def edit(
        self,
        index: QModelIndex,
        trigger: QAbstractItemView.EditTrigger,
        event: Optional[QEvent],
    ) -> bool:
        # 你的原有逻辑
        return True

方法2：用@overload装饰器声明所有重载，再实现兼容的统一方法 #

通过@overload明确子类支持的所有签名，然后写一个能处理所有参数组合的实现：

from typing import overload
from PyQt6.QtWidgets import QTableView, QAbstractItemView, QModelIndex
from PyQt6.QtCore import QEvent, Optional

class MyTableView(QTableView):
    @overload
    def edit(self, index: QModelIndex) -> None: ...

    @overload
    def edit(self, index: QModelIndex, trigger: QAbstractItemView.EditTrigger, event: Optional[QEvent]) -> bool: ...

    def edit(
        self,
        index: QModelIndex,
        trigger: Optional[QAbstractItemView.EditTrigger] = None,
        event: Optional[QEvent] = None,
    ) -> bool | None:
        if trigger is None and event is None:
            super().edit(index)
            return None
        # 处理三个参数的业务逻辑
        return True

两种方法都能让mypy认可子类的方法签名与父类兼容，具体选哪种取决于你的业务需求——如果不需要修改单参数调用的行为，方法1更简洁；如果需要统一处理所有参数组合，方法2更灵活。

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