Python双文件循环导入报错：如何实现类的互相调用？

嘿，这个问题我太熟了——你碰到的是Python模块循环导入的经典坑！咱们先搞清楚为啥会报错：

当你运行One.py时，Python会逐行执行代码：

1. 首先执行from Two import PrintTwo，于是开始加载Two.py
2. Two.py第一行是from One import PrintOne，这时候One.py还没执行完（才刚触发导入Two，自己的PrintOne类还没定义呢），Python找不到已经定义好的PrintOne，反过来One这边也拿不到PrintTwo，直接就抛出cannot import name的错误了。

针对这种两个类需要互相调用功能的场景，给你几个靠谱的处理方案，按推荐程度排序：

1. 重构代码，提取公共逻辑到独立模块（最推荐的长期方案） #

如果两个类互相依赖的是某部分通用功能，不如把这部分抽出来放到一个新的模块里，让One.py和Two.py都从这个公共模块导入，彻底斩断循环依赖。

举个例子：
新建Common.py：

# 把两个类需要互相调用的功能放在这里
def shared_utility():
    print("这是两个类都需要的公共逻辑")

修改One.py：

from Common import shared_utility

class PrintOne(object):
    print('HelloOne')
    
    def use_shared_logic(self):
        shared_utility()

修改Two.py：

from Common import shared_utility

class PrintTwo(object):
    print('HelloTwo')
    
    def use_shared_logic(self):
        shared_utility()

这种方式不仅解决了循环导入，还让代码结构更清晰，后期维护也方便。

2. 延迟导入（快速解决临时需求） #

把导入语句从模块顶部移到需要用到对方类的函数/方法内部，这样模块初始化的时候不会触发循环导入，只有当实际调用方法时才会执行导入，这时候两个类都已经完成定义了。

修改One.py：

class PrintOne(object):
    print('HelloOne')
    
    def call_two_function(self):
        # 只在需要用到的时候才导入
        from Two import PrintTwo
        two_instance = PrintTwo()
        # 在这里调用PrintTwo的功能

修改Two.py：

class PrintTwo(object):
    print('HelloTwo')
    
    def call_one_function(self):
        from One import PrintOne
        one_instance = PrintOne()
        # 在这里调用PrintOne的功能

这个方案适合快速修复现有代码，但如果依赖太多，代码会变得有点乱，所以还是优先考虑重构。

3. 字符串类型提示（针对类型注解场景） #

如果你的循环导入只是因为类型注解里用到了对方的类，可以用字符串来引用类名（Python 3.7+ 需要导入from __future__ import annotations，3.10+ 无需额外导入直接支持），这样类型注解不会触发实际的导入操作。

比如One.py：

from __future__ import annotations  # Python 3.7-3.9需要加这个

class PrintOne(object):
    print('HelloOne')
    # 用字符串标注类型，不会触发导入
    def process_two(self, two_obj: "PrintTwo") -> None:
        pass

# 模块加载完成后再导入
from Two import PrintTwo

Two.py同理：

from __future__ import annotations

class PrintTwo(object):
    print('HelloTwo')
    def process_one(self, one_obj: "PrintOne") -> None:
        pass

from One import PrintOne

内容的提问来源于stack exchange，提问作者K-Doe