含typing子包的Python包引发命名冲突问题求助

核心原因 #

当导入mypackage下的模块时，Python会自动加载mypackage/__init__.py。如果该文件中存在from . import typing这类语句，会将自定义的typing子包注册到mypackage的命名空间（即mypackage.typing）。

若你的代码间接或直接将mypackage.typing导入到全局命名空间，就会覆盖之前导入的内置typing模块——此时访问typing.Final实际指向的是mypackage.typing.Final，而自定义子包没有这个属性，因此触发AttributeError。

常见触发场景：

• mypackage/__init__.py中定义了__all__ = ['typing']，且代码中执行过from mypackage import *，这会把mypackage.typing导入全局，替换内置typing。
• mypackage/__init__.py中主动将typing赋值为自定义子包（比如typing = __import__('.typing', fromlist=[''])），之后代码中执行from mypackage import typing覆盖全局变量。
• mymodule.py中通过相对导入引入mypackage.typing并将其加入__all__，导入MyModule时不小心同时导入了typing（比如from mypackage.mysubpackage.mymodule import MyModule, typing）。

此外，若代码中手动修改了sys.modules['typing']，将其指向mypackage.typing，也会导致后续所有import typing都加载自定义子包，但这种情况较为少见。

验证方式 #

在报错前添加以下代码，查看typing模块的实际路径，确认是否被替换：

import typing
print("初始typing路径:", typing.__file__)

from mypackage.mysubpackage.mymodule import MyModule
print("导入MyModule后typing路径:", typing.__file__)

若导入MyModule后，路径变为mypackage/typing/__init__.py，则说明全局typing确实被自定义子包覆盖。

解决建议 #

1. 重命名子包（推荐）：直接将mypackage/typing改名为typing_utils或其他不与内置模块冲突的名称，从根源避免问题。
2. 隔离命名空间：
   • 移除mypackage/__init__.py中导出typing子包的语句，仅在子模块内部通过相对导入使用自定义typing。
   • 导入自定义子包时使用别名区分：from mypackage import typing as my_typing，避免与内置typing混淆。

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