模块首次import时执行全部顶层代码,后续import直接返回缓存对象;__name__为"__main__"仅在直接运行时成立;循环导入可能因模块未执行完而引发attributeerror;reload会重执行顶层代码但不更新已有引用。

Python脚本作为模块被 import 时,其执行顺序与直接运行(python script.py)有本质区别:**模块首次导入时会完整执行顶层代码(即缩进为0级的语句),之后再导入则直接返回已缓存的模块对象,不再重复执行。** 这是理解 import 行为的核心。
模块导入触发完整执行
当执行 import mymodule 时:
- Python 检查
sys.modules中是否已有该模块名;若无,则定位源文件(如mymodule.py) - 创建新的模块对象,插入
sys.modules中 - 逐行解释执行该文件所有顶层代码(函数定义、类定义、赋值、print、if 语句等)——注意:函数体内部代码此时不执行,仅定义
- 导入语句完成,变量
mymodule指向该已初始化的模块对象
__name__ 决定“是否为主程序”逻辑
脚本中常见写法:
if __name__ == "__main__":
print("我只在直接运行时执行")
这个判断的关键在于:__name__ 在被 import 时值为模块名(如 "mymodule"),只有直接运行时才为 "__main__"。因此,该条件块在 import 过程中**永远不会进入**,它纯粹用于隔离“仅主程序执行”的逻辑。
立即学习“Python免费学习笔记(深入)”;
循环导入中的执行时机很关键
假设 a.py 导入 b.py,而 b.py 又导入 a.py:
- 启动
import a→ 执行a.py顶层代码,遇到import b - 开始执行
b.py,遇到import a→ 此时a已在sys.modules中(但尚未执行完),于是直接返回半初始化的a模块对象 - 若
b.py立即访问a.x,而x是a.py后半部分才定义的变量,则抛出AttributeError
这类问题不是语法错误,而是执行顺序导致的运行时异常,调试时需关注模块加载的先后与完整性。
重载(reload)会再次执行顶层代码
使用 importlib.reload(mymodule) 时:
- 不会新建模块对象,而是复用原对象
- 重新从头执行该模块文件所有顶层语句(函数/类定义会更新,全局变量会被覆盖)
- 已存在的引用(如其他模块中
from mymodule import x得到的x)不会自动更新,仍指向旧对象
reload 主要用于开发调试,生产环境应避免依赖。










