Python模块加载顺序导致循环导入崩溃，因A模块初始化时导入B，B又反向导入未就绪的A；解决方法是用工厂模式延迟创建app和db，或把import移至函数内。
为什么 app 和 models 互相 import 就崩？
因为 Python 模块加载是顺序执行的，一旦 A 模块在初始化时尝试导入 B，而 B 又在定义过程中反向导入 A，A 的模块对象还没构建完，B 就去取 app 或 db 这类未就绪对象——直接抛 ImportError 或 AttributeError。常见报错如 ImportError: cannot import name 'db' from partially initialized module 'models'。
这不是 Flask 特有，但 Flask 项目结构（app.py 创建实例、models.py 需要 db、routes.py 需要 app 和 models）天然容易触发。
- 别在模块顶层直接 import 跨域依赖（比如
from app import db） - 把 import 移到函数/方法内部，延迟到真正需要时才加载
- 用工厂模式重构：把
Flask()和扩展初始化拆到函数里，避免全局变量过早暴露
怎么用工厂函数绕开循环导入？
核心是让 app 和 db 不再是模块级全局变量，而是由函数按需创建并返回。这样 models.py 可以安全地 import 工厂函数，而不是直接依赖未初始化的 db。
示例结构：
# __init__.py from flask import Flask from flask_sqlalchemy import SQLAlchemy <p>db = SQLAlchemy()</p><p>def create_app(): app = Flask(<strong>name</strong>) app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///app.db' db.init_app(app) return app </p>
models.py 里不再写 from app import db，而是：
# models.py from . import db # 此时 db 是空壳，但合法；实际绑定在 create_app() 里完成 <p>class User(db.Model): id = db.Column(db.Integer, primary_key=True) </p>
app.py 或入口文件只负责调用：
# app.py from mypackage import create_app app = create_app()
import 放进路由函数里真能解决问题？
能，而且简单粗暴有效。适用于小项目或临时修复。本质是打破模块加载期的依赖链。
比如原本 routes.py 顶部写了 from models import User，而 models.py 又 from app import db —— 改成：
# routes.py
from flask import Blueprint
<p>bp = Blueprint('main', <strong>name</strong>)</p><p>@bp.route('/')
def index():
from models import User # ✅ 延迟到请求时才 import
users = User.query.all()
return str(users)
</p>
注意点：
- 每次请求都 import 一次？Python 会缓存模块，实际只加载一次
- 不能在类定义、装饰器参数里用这种延迟 import（比如
@login_required里用User就不行） - 如果
models.py本身有顶层 importapp，这招无效，得配合工厂函数一起用
为什么 __name__ == '__main__' 启动时还报错？
因为你在 app.py 里写了 if __name__ == '__main__': app.run()，但此时 app 可能还没被 create_app() 初始化，或者 db 没绑定。更糟的是，某些 IDE 或调试器会先执行模块顶层代码，触发隐式 import 链。
正确做法：
- 入口文件只做一件事：调用工厂函数 + 启动
- 确保所有扩展（
db、login_manager等）都在create_app()内完成init_app() - 不要在任何模块顶层调用
db.create_all()或访问app.config—— 这些必须等app实例存在后才能做
启动脚本应类似：
# run.py from mypackage import create_app <p>app = create_app() if <strong>name</strong> == '<strong>main</strong>': app.run(debug=True) </p>
工厂函数不是银弹，但它把“谁先初始化”这个顺序问题，转成了可控制的函数调用时机。最常被忽略的是：db 必须用 init_app() 而非直接构造时传 app，否则工厂模式失效。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
