Python循环导入本质是设计问题，需打破双向依赖：①抽离共享逻辑为独立模块；②延迟导入至函数内；③类型注解改用字符串；④升级为包结构并分层依赖。
Python中循环导入本质是模块间依赖关系没理清，不是语法问题而是设计问题。解决核心是打破双向依赖，让依赖方向变成单向或引入中间层。
把共享逻辑抽成独立模块
两个模块互相import，往往是因为它们都用到了同一组函数、类或配置。这时最直接的办法是把这些共用内容单独拎出来，新建一个utils.py、models.py或constants.py。
- 原结构：a.py import b，b.py import a → 报错
- 改造后：a.py 和 b.py 都只 import shared.py，不再互导
- 注意：shared 模块里不能反过来 import a 或 b，否则又绕回去了
延迟导入（Deferred Import）
如果某个模块只在特定函数里用到，且不涉及模块级初始化，可以把 import 写在函数内部，而不是文件顶部。
- 适合场景：工具函数、回调处理、非启动路径的逻辑
- 例如：a.py 的某个函数需要调用 b.py 的类，就把 from b import SomeClass 写在该函数第一行
- 这样 import 只在函数执行时发生，避开模块加载期的循环检查
用字符串代替类型注解中的模块引用
类型提示里写 def func(x: b.SomeClass) 会触发提前 import，导致循环。改用字符串字面量可绕过：
立即学习“Python免费学习笔记（深入）”；
- 写成 def func(x: "b.SomeClass") —— 运行时不执行，只被类型检查器（如mypy）解析
- 配合 from __future__ import annotations（Python 3.7+），所有注解默认延迟求值，更安全
- 类内部的 __annotations__ 也不会触发导入
重构为包结构 + 显式接口层
当模块变多、关系复杂时，靠单个文件拆分容易失控。升级为包（package），用 __init__.py 控制对外暴露的入口，内部模块私有化。
- 比如创建 myapp/ 包，下设 core/、services/、api/
- 让 core 作为基础层，其他层只依赖 core，不反向依赖
- __init__.py 中统一导出稳定接口，使用者只 import myapp.xxx，不直接 import 子模块
