循环导入问题可通过延迟导入、重构模块、类型注解和简化依赖解决。1. 将import移至函数内以延迟加载；2. 抽离公共部分到独立模块打破双向依赖；3. 用字符串类型注解或TYPE_CHECKING处理类型提示导入；4. 拆分模块、降低耦合以理清依赖关系，重构为根本解决方案。
Python 中的 import 循环（循环导入）问题通常发生在两个或多个模块相互引用时，导致部分导入失败或变量未定义。虽然 Python 能处理部分循环导入，但容易引发 AttributeError 或 NameError。解决这类问题的核心是重构代码结构和调整导入方式。
1. 延迟导入（局部导入）
将 import 语句移到函数或方法内部，而不是放在模块顶层。这样可以确保在需要时才导入，避免模块初始化阶段就触发循环。
- 适用于调用频率不高、依赖关系明确的场景
- 减少模块加载时的依赖压力
- 示例：在函数中导入而不是文件顶部
例如：
def my_function():
from module_b import some_class
return some_class()
2. 重构模块结构
将共用的部分抽离到第三个模块中，打破原有的双向依赖。
立即学习“Python免费学习笔记（深入）”；
- 把公共类、函数或常量移到一个独立的 utils 或 common 模块
- 原模块只依赖这个新模块，不再互相导入
- 这是最干净、长期维护性最好的方案
比如原本 a.py 导入 b.py，b.py 又导入 a.py，可以新建 shared.py，两者都导入 shared.py 来获取共享内容。
3. 使用类型注解延迟处理
如果循环导入仅用于类型提示（如 Type Hints），可以使用字符串形式的类型注解或导入 typing.TYPE_CHECKING。
from typing import TYPE_CHECKING
if TYPE_CHECKING:
from module_b import SomeClass
def func(x: "SomeClass"):
pass
这样在运行时不会执行导入，只在静态检查时生效。
4. 检查并简化依赖逻辑
有时循环导入是因为设计不合理，比如一个模块做了太多事。可以通过以下方式优化：
- 拆分大模块为更小的功能单元
- 确认是否真的需要跨模块调用，能否通过参数传递代替导入
- 使用接口或回调机制降低耦合度
清晰的职责划分能从根本上避免循环问题。
基本上就这些。关键不是绕过问题，而是理清模块之间的关系。多数情况下，延迟导入能临时解决报错，但重构才是治本之法。不复杂但容易忽略。
