Python模块循环导入报错问题：main.py与simulation.py互相导入无法运行

你预想的执行逻辑存在两个认知偏差：

1. 当你直接执行python main.py时，当前运行的模块在Python的模块缓存sys.modules中存储的键是__main__，而非main。此时sys.modules['main']为空，不存在已加载的main模块。
2. 模块导入时Python会先将空的模块对象写入缓存，再执行模块内的代码，而非等代码全部执行完再写入缓存。如果导入逻辑出现在模块代码执行的中间位置，缓存中的模块只有执行到导入语句前的内容。

具体到你的场景，实际执行流程是：

• 执行python main.py，创建__main__模块，开始执行代码，完成Main类的定义
• 执行到from simulation import Simulation，加载simulation模块，创建空的simulation模块对象写入缓存，开始执行simulation.py代码
• simulation.py执行from main import Main，检查发现sys.modules中没有main模块，因此重新启动main模块的加载流程，创建空的main模块对象写入缓存，从头执行main.py的代码
• 新的main模块执行到from simulation import Simulation时，发现simulation已经在缓存中，但此时simulation模块还未执行完成，还没有定义Simulation类，就会抛出导入错误。

以下三个方案都可以解决你的问题，按优先度排序：

方案1：将执行侧代码放到__name__ == "__main__"保护块中 #

这是最适合你当前场景的方案，修改main.py末尾的代码即可：

class Main :
    @staticmethod
    def newMouton(mouton, i, j) :
        listMoutons.append(mouton)
        listMoutons.append(canvas.create_image(i * coteCarre, j * coteCarre + yMargin, img = imageMouton))
    
    @staticmethod
    def delMouton(mouton) :
        moutonIndex = listMoutons.index(mouton)
        canvas.delete(listMoutons[moutonIndex + 1])   #en ajoutant 1, on retrouve l'obj canvas image à supprimer
        listMoutons.remove(mouton)
        del listMoutons[moutonIndex:(moutonIndex + 2)]

from random import randint

if __name__ == "__main__":
    # 只有直接运行main.py时才会执行这里的代码，作为模块被导入时不会触发
    from simulation import Simulation
    # 其他初始化逻辑，比如创建canvas变量、创建Simulation实例的代码全部放到这个块里

修改后，当simulation导入main模块时，main.py不会再次执行导入simulation的逻辑，循环直接被打破，且Main类已经完成定义，可以正常导入。

方案2：使用局部导入 #

将simulation.py中的导入语句移到方法内部，仅在调用时才执行导入：

class Simulation:
    def __init__(self) : self._moutons = []
    def moutonMort(self, mouton) :
        # 运行到这个方法时，main模块已经完成加载，不会出现导入问题
        from main import Main
        self._moutons.remove(mouton)
        pos = mouton.getPosition()
        Main.delMouton(mouton)
        del mouton

这个方案不需要修改main.py，适合临时修复循环导入问题。

方案3：重构代码拆分依赖 #

将两个模块共同依赖的逻辑抽离到第三个独立模块，消除循环依赖。比如你可以将Main类中操作界面的通用方法抽离到view_utils.py中，main.py和simulation.py都从view_utils.py导入需要的对象，从根源上避免循环导入。

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