为何Python自导入模块在不同执行方式下执行次数有差异？

复现操作与结果 #

以下操作基于CPython 3.10.6：

$ echo 'import x; import x; print("Executing"); import x; import x' >x.py
$ python3 -c 'import x'
Executing
$ python3 x.py
Executing
Executing
$ python3 -m x
Executing
Executing

额外执行的原因 #

核心在于Python模块的两种运行身份：被导入的模块和主脚本，以及import语句的执行逻辑：

1. python3 -c 'import x'的情况
   这里x.py仅作为模块x被导入一次：

   • 执行import x时，Python检查sys.modules（已加载模块的缓存），发现没有x，于是加载x.py并执行其代码，输出一次Executing。
   • 后续的import x都会直接从缓存取，不会重复执行模块代码，所以最终只输出一次。

2. 直接运行python3 x.py的情况
   此时x.py同时扮演了两个角色：

   • 第一步：Python将x.py当作主脚本（模块名为__main__）开始执行，逐行运行代码。
   • 当执行到第一行import x时，Python需要加载名为x的模块，此时sys.modules中没有x，于是再次加载x.py作为模块x执行，输出第一次Executing。
   • 模块x加载完成后，回到主脚本继续执行，运行到print("Executing")时，输出第二次Executing。
   • 后续的import x都从缓存取，不再执行。

3. python3 -m x的情况
   -m参数的作用是让Python将模块x当作主程序运行，流程是：

   • 第一步：Python先导入模块x，执行其代码，输出第一次Executing。
   • 第二步：将模块x的身份切换为主脚本（模块名改为__main__），再次执行模块的全部代码，此时import x会从缓存取，不会重复加载，但print("Executing")会再次执行，输出第二次Executing。

实用场景 #

这种行为并非设计漏洞，而是有实际用途的：

• 模块既可以被导入又可以直接运行：很多Python模块会在代码末尾加上if __name__ == '__main__':判断，当模块作为主脚本运行时，执行测试、示例或命令行逻辑；当被导入时，只提供功能函数/类，不执行额外逻辑。比如：

  def add(a, b):
      return a + b
  
  if __name__ == '__main__':
      # 只有直接运行或用-m运行时才执行测试
      print(add(2, 3))
  

  这种情况下，即便模块里有import自身的语句，也不会触发重复执行测试逻辑，因为导入时__name__不是__main__，只有主脚本模式才会执行判断里的代码。
• 模块级别的初始化与主逻辑分离：通过这种机制，开发者可以把模块的初始化代码（比如配置加载、全局变量定义）放在模块顶层，被导入时自动执行；而主逻辑放在__name__ == '__main__'块中，只有直接运行时才触发，实现代码的复用与执行逻辑的分离。

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