直接用 db.create_all() 建表必须在 app.app_context() 中执行，否则报 RuntimeError；优先选 pymysql（纯 Python、安装快），URI 要带驱动名和 charset=utf8mb4，密码含特殊字符需 url 编码，__tablename__、primary_key 和字段类型须显式声明。
直接用 db.create_all() 就能建表，但必须在 app.app_context() 里执行——否则 90% 的人会卡在 RuntimeError: Working outside of application context 这个错误上。
配置 URI 时 pymysql 和 mysqlclient 怎么选
优先用 pymysql：纯 Python 实现，装得快、没编译依赖，pip install pymysql 后直接用 mysql+pymysql://... 即可；mysqlclient 虽性能略好，但在 Windows 或 M1/M2 Mac 上常因编译失败中断安装。如果你看到 Failed building wheel for mysqlclient，立刻切回 pymysql。
URI 格式必须带驱动名，例如：
火焰围攻 授权: q15040409-creator.功能概述火焰围攻 授权: q15040409-creator.是一项面向实际任务的技能，主要用于Description.；Flask Web. - Python.；核心要点HTTP?；.Version.1.0.tags. wrap.github.automation.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用与执行使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:1234@127.0.0.1:3306/flask_demo?charset=utf8mb4'
-
charset=utf8mb4必须加，否则 emoji 或四字节 UTF-8 字符写入会报错 - 密码含特殊字符（如
@、/）要先用urllib.parse.quote_plus()编码 - 不要漏掉端口号，即使默认 3306 —— 显式写出更稳妥
模型定义最容易漏的三件事
不是所有字段都能靠默认推断，不显式写清楚，查不到数据、建不出表、迁移也失效。
-
__tablename__必须显式声明，否则自动生成的表名是小写+下划线（如User→user），而你手动建的表叫users，User.query.all()就永远返回空列表 - 主键字段必须带
primary_key=True，且整个模型中只能有一个；漏了就建不了表，报No primary key defined - 字符串字段必须用
db.String(长度)，不能用str；时间字段用db.DateTime，不是datetime.datetime—— 否则运行时报AttributeError: type object 'str' has no attribute '__table_args__'
建表和初始化必须绕开应用上下文陷阱
db.create_all() 看似一行，实则强依赖 Flask 应用上下文。在脚本里直接调用，或在模块顶层 import 时执行，100% 报错。
- 正确姿势：用
with app.app_context(): db.create_all() - 如果只是临时验证连接，加一句
db.engine.connect().close()更轻量，不用建表 - 别信“启动时自动建表”的说法——Flask 不会自动触发
create_all，必须你亲手调一次 - 后续改字段？
create_all()不会删旧列、不改类型、不加索引，它只建缺失的表。真要改结构，得用Flask-Migrate，不是本文范围
最常被忽略的是：SQLALCHEMY_TRACK_MODIFICATIONS = False 这行配置不加，应用启动后内存持续上涨，跑几天就 OOM；还有，__tablename__ 拼错一个字母，debug 半小时才发现查的是张不存在的表。
