当使用 exec() 动态执行外部 Python 文件时,若该文件又反向导入了当前主模块(如 from main import mods),会触发主模块被二次加载,导致顶层代码重复运行——这是由 Python 模块导入机制和 __name__ 语义决定的。
当使用 `exec()` 动态执行外部 python 文件时,若该文件又反向导入了当前主模块(如 `from main import mods`),会触发主模块被二次加载,导致顶层代码重复运行——这是由 python 模块导入机制和 `__name__` 语义决定的。
在你的 main.py 中,调用 exec(open("Welder/mods/example.py").read()) 确实只执行了一次 example.py 的内容;但关键问题在于 example.py 内部包含:
from main import mods
这行代码会触发 Python 导入系统重新加载 main.py 模块(即使它已在内存中)。而 Python 在导入模块时,会完整执行其顶层(indented level 0)代码——包括末尾的 printHello() 调用。因此,你看到的两次输出实际来源于:
- 首次执行:python main.py 启动解释器 → 执行 main.py 全文 → exec(...) 加载 example.py → example.py 执行 from main import mods → 再次导入并执行 main.py 全文 → 第二次调用 printHello()。
⚠️ 注意:这不是 exec() 本身的 bug,而是模块循环依赖引发的副作用。exec() 只是“执行字符串”,不参与模块缓存;但 import 语句会强制走标准导入流程,进而触发重复执行。
✅ 正确解决方案:保护顶层逻辑
将 main.py 中所有不应被重复执行的逻辑(尤其是 exec() 后的初始化与函数调用)包裹在 if __name__ == "__main__": 保护块中:
立即学习“Python免费学习笔记(深入)”;
# main.py(修正后)
import os
MODSDIR = 'Welder/mods/'
mods = []
ignoredFiles = ["__init__.py", "__pycache__"]
def register(mod):
if isinstance(mod, str):
mods.append(mod)
else:
print("Welder.error.ERROR: mod ID must be type 'str'")
if __name__ == "__main__":
files = os.listdir(MODSDIR)
# 动态执行每个 mod 文件(注意:需确保安全,生产环境慎用 exec)
for file in files:
if file.endswith(".py") and file not in ignoredFiles:
file_path = f"Welder/mods/{file}"
exec(open(file_path).read())
mods = list(set(mods))
print(mods)
# 确保 printHello 已定义(可从 example.py 中导入或声明)
try:
printHello()
except NameError:
print("Error: printHello() not defined in any loaded mod.")同时,建议重构 example.py,避免反向导入主模块,改用更安全的通信方式:
# example.py(推荐写法)
def init(mods_list):
"""模块初始化钩子:接收外部传入的 mods 列表"""
mods_list.append("example")
def printHello():
print("Hello World!")并在 main.py 中调用:
# 在 if __name__ == "__main__": 块内
for file in files:
if file.endswith(".py") and file not in ignoredFiles:
namespace = {"mods": mods, "printHello": printHello} # 提供上下文
exec(open(f"Welder/mods/{file}").read(), namespace)? 核心总结
- exec() 不等于 import,但 import 会触发模块重执行;
- from X import Y 是隐式导入,等价于 import X; Y = X.Y,必然加载 X;
- 所有顶层副作用(如 print()、函数调用、状态修改)必须用 if __name__ == "__main__": 隔离;
- 生产级插件系统应避免 exec(),优先选用 importlib.util.spec_from_file_location() + module_from_spec() 动态导入,配合明确的接口契约(如要求 mod 必须实现 register(mods) 函数)。
遵循以上原则,即可彻底避免重复执行,构建健壮、可维护的模块化架构。


















