Python中如何处理Img与ImgAnalyzer类的循环依赖导入问题

循环导入的核心原因是两个模块在顶层互相依赖导入，只需打破其中一个顶层导入依赖即可，以下是3种可行的实现方式： #

方案1：使用延迟类型注解（最简便，Python3.7+支持） #

仅需修改img_analyzer.py，利用PEP563的延迟类型注解特性，避免类型标注触发实际的模块导入：
img_analyzer.py代码：

# 首行加这个注解导入，让类型标注延迟到运行时求值
from __future__ import annotations

# 删掉顶层的from img import Img语句
class ImgAnalyzer:
    # 这里直接写Img作为类型标注不会触发导入，注意你原有代码里写的Image是笔误，需改为Img
    def __init__(self, img: Img):
        # 原有初始化逻辑
        pass
    def func(self):
        # 原有分析方法逻辑
        pass

img.py代码保持原有写法即可：

from img_analyzer import ImgAnalyzer
class Img:
    def __init__(self, *args, **kwargs):
        # 原有初始化逻辑
        self.analyzer = ImgAnalyzer(self)
    # 其他方法

此时两个模块不会出现循环导入，你预期的调用方式img = Img(params); img.analyzer.func()完全无需修改。 #

方案2：导入放在方法内部（兼容旧Python版本） #

如果你的Python版本低于3.7，无法使用延迟类型注解，可以把img_analyzer.py中对Img的导入放到需要用到的方法内部，避免顶层导入：
img_analyzer.py代码：

class ImgAnalyzer:
    def __init__(self, img: "Img"): # 用字符串形式的类型标注
        # 原有初始化逻辑
        pass
    def some_method_need_img_attr(self):
        # 只有在实际用到Img类的属性/方法时才导入
        from img import Img
        # 后续逻辑

方案3：依赖倒置（适合大型项目，扩展性更好） #

如果后续两个类还会扩展更多依赖，可以单独新增一个抽象基类模块，让两个具体类都依赖抽象而不是互相依赖：

1. 新增base.py：

from abc import ABC, abstractmethod
class AbstractImg(ABC):
    # 定义Img需要对外暴露的公共方法/属性的抽象定义
    pass

2. 修改img.py：

from base import AbstractImg
from img_analyzer import ImgAnalyzer
class Img(AbstractImg):
    def __init__(self, *args, **kwargs):
        # 原有初始化逻辑
        self.analyzer = ImgAnalyzer(self)
    # 其他方法

3. 修改img_analyzer.py：

from base import AbstractImg
class ImgAnalyzer:
    def __init__(self, img: AbstractImg):
        # 原有初始化逻辑
        pass
    # 其他方法

这个方案完全消除了两个业务模块的互相依赖，后续扩展更灵活。

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