Python中`import`与`import as`的奇怪导入错误排查

我来拆解你遇到的这个问题——这本质是Python模块加载流程中循环导入和不同导入语句的内部执行逻辑差异共同导致的，结合官方文档的模块加载规则就能完全解释清楚。

先复现你的场景 #

目录结构 #

temp
└── temp2
    ├── __init__.py
    ├── mod.py
    └── mod2.py

核心代码 #

__init__.py：

from temp.temp2.mod import *
from temp.temp2.mod2 import *  # 这里触发循环导入

mod2.py（报错版本）：

import temp.temp2.mod as mod  # 报错行

报错信息 #

AttributeError: module 'temp' has no attribute 'temp2'

底层原因：模块加载流程+导入语句的执行差异 #

1. Python模块加载的关键规则（来自官方文档） #

当导入嵌套模块（如temp.temp2.mod2）时，Python的执行顺序是：

• 先创建并加载最顶层模块temp，加入sys.modules；
• 再创建子模块temp.temp2，加入sys.modules，然后开始执行它的__init__.py；
• 注意：只有当temp.temp2的__init__.py完全执行完毕后，Python才会把temp.temp2模块对象赋值给temp模块的temp2属性（也就是temp.__dict__['temp2'] = sys.modules['temp.temp2']）。

2. 循环导入的触发路径 #

当你执行import temp.temp2.mod2时，调用链是：

1. 加载temp → 加载temp.temp2 → 执行temp.temp2.__init__.py；
2. __init__.py先导入mod（没问题，加载完成）；
3. 接着导入mod2，此时开始执行mod2.py；
4. mod2.py执行import temp.temp2.mod as mod，这时问题来了：

3. 不同导入语句的内部逻辑差异 #

这里的核心是**import ... as ...和其他导入语句的底层实现不同**：

• 报错的import temp.temp2.mod as mod：
  这条语句等价于：

  top_module = __import__('temp.temp2.mod', fromlist=[])  # 返回顶层模块temp
  mod = top_module.temp2.mod  # 尝试访问temp.temp2
  

  此时temp.temp2的__init__.py还在执行中（因为它卡在导入mod2这一步），所以temp模块的temp2属性还没有被设置，自然会抛出AttributeError。

• 正常的导入方式为什么没问题？
  我们逐一分析：

  1. import temp.temp2.mod：
     等价于__import__('temp.temp2.mod', fromlist=[])，仅返回顶层模块temp，但不会主动去访问temp.temp2属性——Python只是确保temp.temp2.mod被加载到sys.modules，不需要通过属性链查找，所以不会触发错误。
  2. from temp.temp2.mod import f：
     等价于target_module = __import__('temp.temp2.mod', fromlist=['f'])，这里fromlist不为空，__import__直接返回最底层的temp.temp2.mod模块，不需要通过temp.temp2属性链去查找，自然不会报错。
  3. from temp.temp2 import mod/from temp.temp2 import mod as mod：
     等价于parent_module = __import__('temp.temp2', fromlist=['mod'])，__import__直接返回temp.temp2模块（它已经在sys.modules里了），然后从中取出mod属性（之前__init__.py已经导入过mod，所以temp.temp2的mod属性存在），不需要访问temp.temp2这个属性链，因此没问题。

总结 #

这个问题的本质是：在循环导入的场景下，import ... as ...语句需要通过顶层模块的属性链去访问子模块，但此时父模块的属性还未被Python设置（因为子模块的__init__.py还在执行中）；而其他导入语句要么不需要访问属性链，要么直接从sys.modules中获取目标模块，因此不会触发错误。

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