如何让mypy忽略Python依赖中错误的函数返回类型提示？

问题场景 #

某个第三方Python依赖的类型提示未经过充分测试，存在错误。例如依赖中定义了这样的函数：

def foo() -> object:
    return {"hello": "world"}

实际返回的是字典，但类型标注为object。当在代码中把它的返回值赋值给dict类型变量时：

from dependency import foo

myvar: dict = foo()

mypy会抛出类型不兼容的错误：

error: Incompatible types in assignment (expression has type "object", variable has type "dict[Any, Any]")  [assignment]

尝试用dict()显式转换也无法解决，mypy依然报错：

from dependency import foo

myvar: dict = dict(foo())

错误信息：

error: No overload variant of "dict" matches argument type "object"  [call-overload]

解决方案 #

1. 使用类型断言明确类型 #

直接告诉mypy你确定返回值的真实类型，有两种方式：

• 用typing.cast做类型转换提示：

from typing import cast
from dependency import foo

myvar: dict = cast(dict, foo())

• 针对单行的赋值错误做忽略：

from dependency import foo

myvar: dict = foo()  # type: ignore[assignment]

这种方式仅忽略该行的assignment类型错误，不会影响其他代码的校验。

2. 忽略单个函数的类型提示 #

如果该依赖函数的类型提示长期存在问题，可以在导入时直接忽略它的类型校验：

from dependency import foo  # type: ignore[import]

之后使用foo()时，mypy会跳过对它的类型校验，不会再因类型不匹配报错。

3. 在mypy配置中忽略整个依赖 #

如果整个依赖的类型提示都不可靠，可以在mypy配置文件中标记忽略该依赖的所有类型错误：

• 若使用mypy.ini：

[mypy]
ignore_missing_imports = False
[mypy-dependency.*]
ignore_errors = True

• 若使用pyproject.toml：

[tool.mypy]
ignore_missing_imports = false
[[tool.mypy.overrides]]
module = "dependency.*"
ignore_errors = true

这种方式适合依赖整体类型提示质量较差的场景。

4. 临时屏蔽单行所有类型错误 #

如果只是临时处理某一行的问题，可以直接在末尾添加# type: ignore屏蔽该行所有类型校验（不推荐，可能会漏掉其他潜在问题）：

myvar: dict = foo()  # type: ignore

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