使用importlib动态导入模块时如何添加类型提示解决mypy报错

方案1：使用Protocol定义模块结构（推荐） #

因为你可以确定所有动态导入的模块都包含固定结构的Foo类，可以通过typing.Protocol定义模块的期望结构，既可以消除mypy报错，还能保留完整的类型检查、代码补全能力。

完整示例代码如下：

import importlib
from typing import Protocol, Type

# 定义期望的内部类结构
class _Bar(Protocol):
    x: int

class _Foo(Protocol):
    Bar: Type[_Bar]

# 定义动态导入模块的协议：只要包含符合要求的Foo属性就匹配
class DynamicModule(Protocol):
    Foo: Type[_Foo]


module_path = "mod"
# 给导入的模块加上协议类型注解
mod: DynamicModule = importlib.import_module(module_path, package=None)
# 此处mypy不会报错，还能正确识别Foo、Bar、x的类型
print(mod.Foo.Bar.x)

方案2：使用type: ignore（仅推荐临时/结构极复杂场景使用） #

如果模块结构非常复杂，写Protocol的成本过高，可以选择指定错误码忽略报错，注意要尽量缩小ignore的作用范围，同时明确指定错误码attr-defined，避免意外忽略其他类型错误。

示例：

import importlib

module_path = "mod"
mod = importlib.import_module(module_path, package=None)
# 仅忽略该行的attr-defined错误，不影响其他代码的类型检查
print(mod.Foo.Bar.x) # type: ignore[attr-defined]

如果后续需要多次使用mod.Foo，可以一次性赋值加忽略，避免每一行都加ignore：

Foo = mod.Foo # type: ignore[attr-defined]
print(Foo.Bar.x)

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