PyCharm中如何为动态导入的模块变量手动指定类型提示

要实现你需要的动态模块类型提示，可通过以下两种常用方案实现，均可被PyCharm正确识别：

方案1：单文件局部类型声明 #

这种方案适合仅在少数文件中导入该模块的场景，不会影响项目其他部分逻辑：

from typing import Union, TYPE_CHECKING
from pyqtgraph.Qt import QtWidgets

# 仅静态类型检查阶段执行，运行时会被忽略，不会额外导入依赖
if TYPE_CHECKING:
    import PyQt5.QtWidgets
    import PySide2.QtWidgets
    # 为QtWidgets指定联合类型
    QtWidgets: Union[type(PyQt5.QtWidgets), type(PySide2.QtWidgets)]

你也可以直接将类型声明写在导入行的注释中，效果一致：

from typing import Union, TYPE_CHECKING

if TYPE_CHECKING:
    import PyQt5.QtWidgets
    import PySide2.QtWidgets

from pyqtgraph.Qt import QtWidgets  # type: Union[PyQt5.QtWidgets, PySide2.QtWidgets]

方案2：全局存根文件声明 #

如果项目内多处导入了该模块，可通过自定义存根文件实现全局生效：

1. 在你的项目根目录新建stubs/pyqtgraph/文件夹，在其中创建Qt.pyi存根文件
2. 在Qt.pyi中写入以下内容：

from typing import Union
import PyQt5.QtWidgets
import PySide2.QtWidgets

QtWidgets: Union[type(PyQt5.QtWidgets), type(PySide2.QtWidgets)]

3. 打开PyCharm设置，将stubs文件夹标记为「源根（Sources Root）」，PyCharm会自动读取该目录下的存根文件作为类型补充，所有导入pyqtgraph.Qt.QtWidgets的位置都会自动应用该类型提示。

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