最稳的配置方式是类继承+app.config.from_object()，因可复用共性配置、避免重复、早暴露错误，且from_object()需传类而非实例，加载时机须在flask实例化后、注册蓝图前。
直接用类继承 + app.config.from_object() 是最稳的路，别碰 from_pyfile() 或硬编码字符串拼接。
为什么必须用类继承而不是多个 config.py 文件
多个独立 config.py（比如 dev.py、prod.py）看似清晰，但共性配置（如日志格式、JSON 序列化开关）会重复写四遍，改一处漏三处；而类继承天然支持复用：基类定义通用项，子类只覆盖差异字段。更重要的是，from_pyfile() 不支持继承逻辑——它只是把文件里所有大写变量一股脑塞进 app.config，没法自动合并父类值。
- 基类
Config可定义JSON_SORT_KEYS = False、LOG_FORMAT = "%(asctime)s %(levelname)s: %(message)s" - 子类
ProductionConfig只需写DEBUG = False、SESSION_COOKIE_SECURE = True，其他全继承 - 若误删基类中的
SECRET_KEY定义，子类又没重写，启动时直接报KeyError，比静默失败更早暴露问题
app.config.from_object() 的参数必须是类，不是实例
常见错误是写 app.config.from_object(Config())，看着像初始化，实则失效——from_object() 内部靠 getattr(cls, attr) 扫描类属性，传实例会导致所有配置项被跳过，且不报错。你 debug 时看到 app.config['DEBUG'] 是 None，却找不到原因。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 正确写法：
app.config.from_object('config.ProductionConfig')（字符串路径）或先from config import ProductionConfig，再app.config.from_object(ProductionConfig) - 类里所有大写字母命名的属性才会被加载，
debug或_DATABASE_URL都无效 - 类可以有
__init__，但不会被调用；别在里面做数据库连接或读文件等副作用操作
环境变量怎么选对配置类：优先读 FLASK_CONFIG，不是 FLASK_ENV
FLASK_ENV 在 Flask 2.3+ 已被标记为 deprecated，官方推荐用 FLASK_CONFIG 指向具体类路径（如 config.ProductionConfig）。靠 if env == 'production' 这种硬判断极易漏掉预发、灰度等中间环境，也难以测试。
- 启动前设环境变量：
export FLASK_CONFIG=config.ProductionConfig - 工厂函数里统一处理：
config_name = os.getenv('FLASK_CONFIG', 'config.DevelopmentConfig')，然后app.config.from_object(config_name) - 敏感字段如
SECRET_KEY必须从环境变量读：os.environ['SECRET_KEY']，基类里别给默认字符串，避免本地调试时无意提交明文密钥
配置加载时机不能错：必须在 Flask() 实例化之后、注册蓝图之前
顺序错了会导致扩展（比如 SQLAlchemy、Mail）初始化失败——它们依赖 app.config 里的值，但此时还没加载。常见症状是 RuntimeError: working outside of application context 或扩展报“missing configuration key”。
- 错误顺序：
app = Flask(__name__); register_blueprints(app); app.config.from_object(...) - 正确顺序：
app = Flask(__name__); app.config.from_object(...); register_blueprints(app) - 如果用了工厂模式，
create_app()函数里只做三件事：创建 app、加载 config、注册扩展；数据库连接、后台任务等都应拆到单独初始化函数中调用
最容易被忽略的是子类忘记调 super().__init__()——尤其当基类 __init__ 里做了环境校验或动态生成值（比如根据 ENV 拼接 REDIS_URL），漏掉这句就等于跳过整个初始化链。这不是语法错误，而是逻辑断层，查起来极慢。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
