Flask工厂函数不能直接返回app实例，因为需先加载配置、初始化扩展、注册蓝图后再生成已配置好的应用实例，否则会导致循环导入、上下文错误或环境僵化；典型结构为：创建app→加载配置→init_app()初始化扩展→register_blueprint()注册蓝图→return app。
Flask工厂函数为什么不能直接返回 app 实例？
因为 Flask 应用在创建时若立即调用 app = Flask(__name__)，会绑定当前模块的配置、蓝图和扩展——这会让测试、多环境部署（dev/test/prod）变得僵硬。工厂模式的核心是「延迟实例化」：配置加载完、扩展初始化好、蓝图注册完毕之后，再生成 app。
怎么写一个基础的 create_app() 工厂函数？
它通常放在 app/__init__.py 或 app/factory.py 中，接收配置名（如 "development"）作为参数，返回已配置好的 Flask 实例：
from flask import Flask from app.config import config_by_name <p>def create_app(config_name="default"): app = Flask(<strong>name</strong>) app.config.from_object(config_by_name[config_name])</p><pre class="brush:php;toolbar:false;"># 初始化扩展（如 SQLAlchemy、LoginManager） from app.extensions import db, login_manager db.init_app(app) login_manager.init_app(app) # 注册蓝图 from app.main import bp as main_bp app.register_blueprint(main_bp) return app
-
config_by_name是一个字典，映射字符串配置名到配置类（如DevelopmentConfig） - 所有扩展必须用
init_app(app)而非直接传app构造，否则无法支持工厂模式 - 蓝图注册必须在
app创建后、返回前完成；不能在模块顶层执行app.register_blueprint(...)
为什么 flask run 找不到 app？
CLI 默认找当前目录下 app 或 application 变量。工厂模式下没有全局 app，需显式告诉 CLI 怎么调用工厂函数：
立即学习“Python免费学习笔记（深入）”；
- 设置环境变量：
FLASK_APP="app.factory:create_app('development')" - 或在
manage.py中手动调用：app = create_app("production")，再运行app.run() - 注意括号和引号：
create_app('development')是函数调用表达式，不是字符串名 - 如果报错
ImportError: cannot import name 'app'，说明 CLI 仍在找模块级变量，没走工厂路径
工厂里初始化数据库时常见陷阱
SQLAlchemy 的 db.create_all() 不能在工厂函数中直接调用——此时 app 虽已存在，但还没进入应用上下文（app.app_context()），表模型可能未被导入，导致找不到表定义。
- 正确做法：在 CLI 命令或应用启动后首次请求时触发建表，例如用
@app.before_first_request（已弃用）或更稳妥的自定义命令 - 推荐方式：写一个
flask init-db命令，在其中手动推入上下文：with app.app_context(): db.create_all() - 别在
create_app()末尾加db.create_all()，它会静默失败或报RuntimeError: Working outside of application context
工厂模式本身不难，难的是所有依赖项（扩展、蓝图、命令、配置）都得适配「无全局 app」这个前提。漏掉任何一个 init_app() 或提前执行了上下文敏感操作，就会在启动时或第一次请求时报错，而且错误堆栈往往不直接指向问题源头。
