flask-appbuilder（fab）快速生成管理后台的前提是严格遵循其约定：必须先定义继承db.model的sqlalchemy模型（含主键和显式__tablename__），再注册modelview；跳过模型声明或忽略配置会导致fabmanager命令报错、界面无法渲染。
Flask-AppBuilder（FAB）不是“快速生成管理界面”的万能按钮，它需要你先定义好数据模型和权限逻辑；跳过模型声明或忽略 SQLAlchemy 配置，fabmanager create-admin 会直接报错退出。
必须先写好 SQLAlchemy 模型才能注册 View
FAB 的 ModelView 不接受裸字典或临时对象，它依赖已注册的 db.Model 子类。没模型，就等于没“原料”，整个界面连列表页都渲染不出来。
- 模型类必须继承
db.Model，且至少有一个主键字段（如id = Column(Integer, primary_key=True)） -
__tablename__最好显式声明，避免 FAB 自动生成的表名与实际数据库不一致 - 字段类型要匹配后端数据库——比如 PostgreSQL 的
JSONB字段在 SQLite 下会报OperationalError - 如果用
flask-sqlalchemy多 db 实例，确保ModelView.model绑定的是被appbuilder初始化过的那个db
fabmanager 命令只在初始化阶段有效
fabmanager create-admin 和 fabmanager create-db 是一次性操作，它们不会监听模型变更，也不会自动同步字段增删。
- 新增模型后，必须手动运行
fabmanager create-db（仅当使用SQLAInterface且未启用迁移时） -
create-admin生成的用户密码是明文传参，生产环境务必改用flask shell+appbuilder.sm.add_user(...)方式创建 - 若已存在
ab_user表，create-db不会覆盖或重建，它只建缺失的表——这意味着字段变更需靠flask-migrate手动处理
ModelView 配置项直接影响字段可见性与行为
很多字段默认不显示，不是 bug，是 FAB 的安全默认：它只暴露主键和字符串字段，其余全需显式配置。
-
list_columns决定列表页显示哪些字段；漏写id，列表里就看不到主键，编辑/删除按钮全部失效 -
edit_columns和add_columns必须包含所有可编辑字段，否则表单提交时会因Unknown field报错 - 日期字段要用
Column(DateTime)，不能用String存时间戳，否则datetimepicker小控件不会自动加载 - 外键字段需配合
QuerySelectField或QuerySelectMultipleField，并在datamodel中声明related_views，否则下拉框为空
最常被忽略的是 BaseView 和 ModelView 的注册顺序：必须先 appbuilder.add_view() 再调用 appbuilder.add_separator()，否则菜单栏错位；另外，FAB 的 CSRF 保护默认开启，AJAX 提交表单时得带 X-CSRFToken header，不然 400 错误没提示。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
