如何让VSCode的Pylance识别__init__.py中动态创建的Python模块别名

我明白你遇到的问题了——动态创建的模块别名在运行时完全正常，但Pylance这类静态分析工具因为不会实际执行代码，根本看不到你在运行时注册的my_package.alias模块，自然没法提供自动补全和类型检查。我这里有几个不用写stub文件、也不会过度污染包结构的解决方案，你可以试试：

方案一：用TYPE_CHECKING条件导入给Pylance“人工提示” #

Python的typing.TYPE_CHECKING常量是专门给静态分析工具准备的——它在运行时的值是False，不会影响代码执行，但Pylance这类工具会把它当成True来解析代码。你可以利用这一点，在__init__.py里给Pylance单独提供模块别名的类型提示，同时保留原来的动态逻辑：

from typing import TYPE_CHECKING

# 仅在类型检查阶段导入真实模块，给Pylance提供识别依据
if TYPE_CHECKING:
    # 告诉Pylance：my_package.alias 就是 my_package.sub_module.example 的别名
    from my_package.sub_module import example as alias
    # 标记当前包包含子模块alias，进一步强化Pylance的识别
    __path__ = []  
else:
    # 你的原有动态导入逻辑保持不变
    import importlib
    import sys
    from types import ModuleType

    example_module = importlib.import_module("my_package.sub_module.example")
    alias_module = ModuleType("my_package.alias")
    alias_module.example_function = example_module.example_function
    sys.modules["my_package.alias"] = alias_module

这样修改后，运行时依然用你原来的动态创建逻辑，而Pylance会通过TYPE_CHECKING分支的代码，把my_package.alias识别成真实的子模块，自动补全和类型检查就能正常工作了。

方案二：创建极简的alias.py文件（最省心的备选） #

如果能接受新增一个几乎为空的文件，这是最直接的解决办法：在my_package目录下新建一个alias.py文件，里面只写一行导入代码：

# my_package/alias.py
from my_package.sub_module.example import *

之后你可以删掉__init__.py里的动态创建代码——这个文件本身就是my_package.alias模块，Pylance能直接识别它，运行时也能正常导入使用。一个只有一行代码的文件完全算不上“污染结构”，反而让代码更直观。

为什么你之前的__all__方法没用？ #

你试过的__all__声明只是告诉Python：my_package包导出alias这个属性，但Pylance会把它当成包的一个普通属性（比如一个模块对象），而不是一个可独立导入的子模块，所以没法支持from my_package.alias import ...这种语法——这和我们要的模块别名不是一回事。

备注：内容来源于stack exchange，提问作者Gary Frewin