使用更通用类型做类型提示时Mypy报错的原因与解决方法

Mypy在静态类型检查时，将TypedDict视为一种结构化的特殊类型，而非普通Dict的子类。尽管运行时TypedDict实例本质就是字典，但Mypy的类型系统不认为二者存在直接兼容关系——它会严格校验返回值的类型标注与实际返回类型的匹配度，因此直接返回TypedDict实例给标注为Dict的函数会触发类型不兼容错误。

方法1：使用类型断言 #

通过cast明确告知Mypy将TypedDict实例转换为Dict类型：

from typing import Dict, TypedDict, cast

class SomeDictionary(TypedDict):
    key: str

def function() -> Dict:
    some_dictionary: SomeDictionary = {"key": "value"}
    return cast(Dict, some_dictionary)

方法2：转换为普通字典 #

利用dict()构造器将TypedDict实例转为普通字典，Mypy会自动识别其类型为Dict[Any, Any]：

from typing import Dict, TypedDict

class SomeDictionary(TypedDict):
    key: str

def function() -> Dict:
    some_dictionary: SomeDictionary = {"key": "value"}
    return dict(some_dictionary)

方法3：使用Any类型过渡 #

如果不想引入额外转换，也可以先将变量标注为Any再返回，但这种方式会削弱类型检查的严格性，仅建议在特定场景下使用：

from typing import Dict, TypedDict, Any

class SomeDictionary(TypedDict):
    key: str

def function() -> Dict:
    some_dictionary: SomeDictionary = {"key": "value"}
    temp: Any = some_dictionary
    return temp

内容的提问来源于stack exchange，提问作者Antonio Gamiz Delgado