为什么Python导入模块会执行一遍代码_通过if name == main进行封装

林译川

2026-09-23 • 👁 0人浏览过

Python导入模块时执行顶层代码是设计行为，即首次加载时解释器逐行执行模块内函数/类定义外的语句，包括副作用操作；if name == "__main__"仅区分运行方式，不阻止导入执行。 Python 导入模块时执行顶层代码，是语言设计的明确行为，不是 bug，也不是意外——它本质是模块初始化过程的一部分。你看到的“执行一遍”，其实是模块被首次加载进

sys.modules

时，解释器逐行执行其顶层语句（即不在函数/类定义内的代码）的结果。为什么 import 会触发执行模块不是“声明”，而是“可执行对象”。当你写

import mymodule

，Python 做了三件事：搜索

mymodule.py

、创建模块对象、执行该文件所有顶层代码。这包括

print()

、变量赋值、函数定义（只是注册，不调用）、甚至

requests.get()

这类副作用操作。函数和类定义本身不会运行，但它们的 body 在定义时会被解析，且若含顶层语句（比如装饰器里调用了函数），那些也会执行如果模块已被导入过（存在于

sys.modules

中），后续

import

不再执行，直接复用已有模块对象

from module import x

同样触发完整执行，只是只把

x

绑定到当前命名空间

if __name__ == "__main__"

的真实作用这个判断不是用来“阻止导入时执行”的开关，而是区分“模块是被直接运行”还是“被别人导入”。它本身不改变导入行为，只是让某些代码块在导入时不进入执行流。当 Python 运行一个脚本文件（如

python script.py

），该文件的

__name__

被设为

"__main__"

当该文件被

import

时，

__name__

是模块名（如

"script"

），所以

if

块被跳过它常用于放测试代码、命令行入口或调试打印——这些本就不该在被导入时触发示例：

mymath.py

内容：立即学习 “ Python免费学习笔记（深入） ”； Python 3.14.3 微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。下载

print("模块正在加载")
def add(a, b): return a + b
if __name__ == "__main__":
    print("这是直接运行，不是导入")

执行

import mymath

会输出“模块正在加载”，但不输出第二句。容易踩的坑：你以为封住了，其实没封住很多人以为加了

if __name__ == "__main__"

就能安全导入，但以下情况仍会意外执行：模块内有顶层

try/except

块，而异常在导入时抛出（比如依赖环境变量未设置）顶层调用了函数，而该函数内部有副作用（例如写文件、连数据库、启动线程）使用了

from module import *

，可能触发模块中

__all__

外的变量初始化逻辑动态导入（如

importlib.import_module("mymodule")

）同样触发执行，和普通

import

行为一致真正可控的初始化方式如果模块需要延迟初始化（比如避免导入时就加载大模型或连接服务），不要依赖

if __name__

，而应把副作用逻辑封装进函数或类，并显式调用：把初始化动作移到函数里：

def init_db(): ...

，使用者按需调用用模块级懒加载模式：用

None

占位，第一次访问时才创建（配合

property

或函数缓存）避免在模块顶层做任何非定义类/函数/常量的操作；把“启动逻辑”留给上层控制最易忽略的一点：模块的执行顺序是确定的，但多个模块间的导入循环、相对导入路径错误、

__init__.py

中的代码位置，都会让“哪段先执行”变得难以预测——这时候靠

if __name__

已经不够用了，得靠结构拆分和显式初始化控制。

相关文章