应用工厂模式必须用于需多环境配置、测试隔离及动态扩展初始化的项目；单文件小项目若无此需求可直接初始化Flask实例。
为什么直接初始化 Flask 实例会导致测试和配置困难
因为 Flask(__name__) 一执行就绑定了当前模块的上下文，后续无法动态切换配置、数据库连接或日志级别。测试时想换一个测试数据库？得改代码或靠环境变量硬编码——这已经违背了应用工厂的核心目的。
典型症状包括：RuntimeError: working outside of application context、测试用例间共享全局 db 实例导致数据污染、开发/生产配置混在同一个 app.py 里难以维护。
- 所有扩展（如
SQLAlchemy、Marshmallow）必须延迟绑定，不能在模块顶层调用init_app() -
create_app()函数必须接收配置标识（如config_name），而不是读取全局os.environ后立刻决定行为 - 蓝图注册、错误处理器、CLI 命令都应在函数体内完成，而非模块级 import 后立即挂载
如何写出可复用的 create_app() 函数
它不是“创建一个 app”，而是“按需组装一个隔离、可配置、可销毁的 app 实例”。关键在于控制权移交：配置解析、扩展初始化、蓝图挂载全部收口到这个函数内。
示例骨架：
def create_app(config_name=None):
app = Flask(__name__)
<pre class="brush:php;toolbar:false;"># 1. 加载配置（优先级：传入参数 > 环境变量 > 默认）
app.config.from_object(config[config_name or os.getenv('FLASK_ENV', 'default')])
# 2. 初始化扩展（注意：不传 app！）
db.init_app(app)
migrate.init_app(app, db)
# 3. 注册蓝图（避免循环导入，用字符串路径或延迟 import）
from myapp.auth import bp as auth_bp
app.register_blueprint(auth_bp, url_prefix='/auth')
# 4. 添加 CLI 命令（确保命令只对当前 app 生效）
@app.cli.command()
def init_db():
db.create_all()
return app
- 不要在函数外定义
db = SQLAlchemy()后直接调用db.init_app(app)——这没问题；但若写成db = SQLAlchemy(app)，就又退回到旧模式 - 配置类应继承自基类，比如
class Config: SECRET_KEY = os.environ.get('SECRET_KEY')，子类覆盖特定字段，而非拼接字典 - 如果用了
flask run，需通过FLASK_APP="myapp:create_app()" FLASK_ENV=development启动，括号不能省
什么时候必须用工厂，什么时候可以不用
单文件小项目（
- 需要为单元测试启动多个隔离的
app实例（比如一个带 auth，一个不带） - 部署时要同时跑 dev/staging/prod 三套配置，且数据库 URL、密钥、调试开关全不同
- 项目拆分成多个子包（
api/、admin/、models/），模块间不能有隐式依赖app全局对象 - 要用
pytest-flask或自定义 fixture 控制应用生命周期
容易被忽略的一点：工厂模式下，current_app 在模块顶层不可用——所有依赖 app 上下文的逻辑（如日志配置、模板过滤器注册）必须放进 create_app() 或用 @app.before_first_request（已弃用）/ app.before_request 替代。
常见陷阱：扩展初始化顺序和循环导入
最常踩的坑不是语法错，而是扩展之间依赖没理清。比如 flask-migrate 必须在 SQLAlchemy 之后调用 init_app()，否则报 AttributeError: 'SQLAlchemy' object has no attribute 'metadata'；又比如蓝图里引用了 db，但 db 还没被 init_app() 绑定，就会触发 RuntimeError: Application not registered on db instance。
- 把所有扩展实例（
db,migrate,login_manager）统一放在extensions.py中定义，不传参，只暴露对象 - 蓝图内部不要做
from myapp import db后直接调用db.session；改用with app.app_context():包裹，或确保该蓝图只在create_app()内注册后才被使用 - 如果用
importlib.import_module动态加载蓝图，注意 Python 模块缓存——同一进程内多次调用create_app()可能因模块已加载而跳过初始化逻辑
真正麻烦的从来不是写对工厂函数，而是让团队所有人理解：每个 app 都是临时的，current_app 是上下文变量，不是全局单例——这点一旦松懈，两周后就会在某个异步任务里看到 Working outside of application context。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
