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免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
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__ 已经不够用了，得靠结构拆分和显式初始化控制。
