如何避免多文件类层级结构中的循环导入问题

循环导入的核心诱因是父类工厂方法硬编码了所有子类的直接依赖，打破了模块间的单向依赖规则，下面提供两种可落地方案，优先选第一种。

方案1：注册表模式（最优解，无循环导入、符合开闭原则） #

这个方案的核心是在父类中维护一个「类型标识->子类」的映射注册表，父类永远不需要主动导入子类，子类定义完成后自行完成注册，依赖全程是子类单向引用父类，从根源上避免循环导入。

Python 3.6+ 可以直接用内置的__init_subclass__钩子实现自动注册，完全不需要手动写注册逻辑：

1. 父类独立模块base.py代码：

class ParentClass:
    # 类级别注册表，存储所有子类的映射关系
    _subclass_registry = {}

    def __init_subclass__(cls, class_type: str = None, **kwargs):
        # 子类被定义时会自动触发该方法，完成自动注册
        super().__init_subclass__(**kwargs)
        if class_type is not None:
            cls._subclass_registry[class_type] = cls

    @classmethod
    def create_subclass(cls, class_type: str, xml):
        # 从注册表查找目标类，找不到则返回父类实例
        target_cls = cls._subclass_registry.get(class_type, cls)
        return target_cls(xml)

    def __init__(self, xml):
        print('\nParent stuff done.')

2. 子类独立模块（以child_a.py为例，child_b.py逻辑一致）：

from .base import ParentClass

# 定义子类时传入class_type参数，会被自动注册到父类注册表
class ChildClassA(ParentClass, class_type='childA'):
    def __init__(self, xml):
        super().__init__(xml)
        print('Class A stuff done.')

3. 使用注意事项：
   调用create_subclass前需要保证所有子类都已被加载，否则注册表不会有对应条目。两种简单处理方式：

• 子类数量固定时，在包的__init__.py中显式导入所有子类，导入包时自动完成注册
• 子类频繁增减时，写一段简单的目录扫描逻辑，动态导入指定路径下的所有子类模块，无需手动维护导入列表

这个方案完全符合开闭原则：新增子类时不需要修改父类的任何代码，只需要在子类定义时指定对应的类型标识即可，维护成本极低，适合类层级持续扩张的场景。

方案2：延迟导入（临时方案，不推荐长期使用） #

如果不想改动现有工厂方法的逻辑，可以把导入子类的语句放到create_subclass方法内部，把模块导入时机从模块加载阶段推迟到方法调用阶段，也能避开循环导入问题：

# 父类模块base.py
class ParentClass:
    @staticmethod
    def create_subclass(class_type: str, xml):
        if class_type == 'childA':
            # 方法内部才导入子类，不会触发模块加载阶段的循环依赖
            from .child_a import ChildClassA
            return ChildClassA(xml)
        elif class_type == 'childB':
            from .child_b import ChildClassB
            return ChildClassB(xml)
        else:
            return ParentClass(xml)

    def __init__(self, xml):
        print('\nParent stuff done.')

这个方案的缺点非常明显：每新增一个子类就要修改父类的工厂方法，if-elif分支会随着子类增多越来越臃肿，维护成本高，只适合类结构完全固定、几乎不会新增子类的小型场景。

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