类方法重载返回类型触发Pylint E1136错误问题排查

这是Pylint 3.0.3对类内方法重载的类型推导存在局限性导致的误报，你的代码逻辑本身没有错误——编辑器能正确识别返回值类型为list[CType]就证明了这一点，只是Pylint未能正确解析类内重载方法的类型关联。

以下是几种可行的解决方法：

方法一：调整实例属性的类型注解位置 #

将类级别的__config注解移到__init__方法的实例属性上，让Pylint更清晰地识别实例属性的类型：

class Test:
    def __init__(self):
        # 直接在实例属性上添加类型注解
        self.__config: dict[str, list[AType] | list[BType] | list[CType]] = {
            "a": [{"prop_a": "a"}], 
            "b": [{"prop_b": "b"}], 
            "c": [{"prop_c": "c"}]
        }

    @overload
    def func(self, s: Literal["a"]) -> list[AType]: ...
    @overload
    def func(self, s: Literal["b"]) -> list[BType]: ...
    @overload
    def func(self, s: Literal["c"]) -> list[CType]: ...
    def func(self, s: Literal["a"] | Literal["b"] | Literal["c"]) -> list[AType] | list[BType] | list[CType]:
        return self.__config[s]

方法二：用typing.cast明确返回类型 #

在方法实现中通过cast强制转换返回值类型，帮助Pylint识别具体的返回类型：

from typing import cast, Literal, TypedDict, overload

# 类型定义部分不变

class Test:
    __config: dict[str, list[AType] | list[BType] | list[CType]]

    def __init__(self):
        self.__config = {"a": [{"prop_a": "a"}], "b": [{"prop_b": "b"}], "c": [{"prop_c": "c"}]}

    @overload
    def func(self, s: Literal["a"]) -> list[AType]: ...
    @overload
    def func(self, s: Literal["b"]) -> list[BType]: ...
    @overload
    def func(self, s: Literal["c"]) -> list[CType]: ...
    def func(self, s: Literal["a"] | Literal["b"] | Literal["c"]) -> list[AType] | list[BType] | list[CType]:
        if s == "a":
            return cast(list[AType], self.__config[s])
        elif s == "b":
            return cast(list[BType], self.__config[s])
        else:
            return cast(list[CType], self.__config[s])

方法三：忽略Pylint误报 #

如果确认代码逻辑正确，可直接在报错行添加注释忽略该错误：

test = Test()
x = test.func("c")
y = x[0]["prop_c"] # pylint: disable=E1136

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