Flask-SuperAdmin快速上手教程：5分钟搭建你的第一个管理后台-港品优选

Flask-SuperAdmin快速上手教程：5分钟搭建你的第一个管理后台

【免费下载链接】Flask-SuperAdminThe best admin interface framework for Flask. With scaffolding for MongoEngine, Django and SQLAlchemy.项目地址: https://gitcode.com/gh_mirrors/fl/Flask-SuperAdmin

Flask-SuperAdmin 是一款功能强大的Flask 管理后台框架（admin interface framework），风格类似 Django Admin，内置 SQLAlchemy、MongoEngine、Django 三种模型的 CRUD 脚手架，还附带文件管理组件。装好一个包，几行代码就能让数据模型自动拥有增删改查的 Web 管理界面——本文将带你 5 分钟完成搭建。

它是什么：Flask 生态里的"管理后台神器"

很多 Flask 项目都要做后台：管理用户、内容、订单……手写表单和页面非常繁琐。Flask-SuperAdmin 的思路是：

自动脚手架：注册一个模型，立刻获得列表页、添加/编辑表单、删除功能
可扩展：管理后台以"视图类"为积木，可自由定制任意复杂度的页面
自带文件管理：上传、删除、重命名服务器文件，开箱即用

💡 它的界面风格深受 Django Admin 影响，如果你熟悉 Django，几乎零学习成本。

最快安装方法：一条 pip 命令搞定

pip install Flask-SuperAdmin

依赖要求很低，核心只需 requirements.txt 中列出的Flask和Flask-WTF（WTForms 表单框架），其余 ORM（如flask-sqlalchemy、mongoengine、django）按需安装即可。

5分钟搭建你的第一个管理后台

下面以最常用的SQLAlchemy + 内存数据库为例（完整可运行代码见 examples/sqlalchemy/simple.py）。

第一步：创建应用并初始化 Admin 实例

from flask import Flask from flask.ext.superadmin import Admin app = Flask(__name__) # 第二参数是显示在导航栏上的应用名称 admin = Admin(app, name='My App')

运行后访问http://localhost:5000/admin/，你会看到一个带顶部导航栏的空白 Home 页——这就是管理后台的骨架。

第二步：注册模型，自动生成增删改查

以User模型为例（db是 Flask-SQLAlchemy 实例）：

admin = Admin(app, name='MyApp') admin.register(User, session=db.session)

仅仅一行register，User模型就拥有了完整的后台管理界面：列表、批量删除、添加、编辑。

第三步：运行并查看效果

db.create_all() # 建表 app.run(debug=True)

打开浏览器，你会看到模型列表页，点击右上角ADD USER即可进入编辑页——所有表单字段由模型自动推导：

🎉 到这里，你的第一个 Flask 管理后台已经跑起来了。

进阶玩法：自定义视图与菜单分类

如果不需要 CRUD，只想加一个自定义管理页面，继承BaseView即可（示例见 examples/simple/simple.py）：

from flask.ext.superadmin import BaseView, expose class MyView(BaseView): @expose('/') def index(self): return self.render('index.html') admin.add_view(MyView(name='Hello', category='Test'))

通过category参数可以把多个视图归入同一个顶部菜单分类，组织大型后台非常直观。

附赠能力：内置文件管理组件

Flask-SuperAdmin 还自带 FileAdmin，可在后台上传、删除、重命名服务器文件，一行代码接入：

from flask.ext.superadmin.contrib.fileadmin import FileAdmin admin.add_view(FileAdmin(path, '/static/', name='Static Files'))

上传类型限制、禁止删除等安全选项可参考 flask_superadmin/contrib/fileadmin.py 的文档说明。

访问控制：谁能看到你的后台

默认情况下后台对所有人可见。要限制访问，重写视图的is_accessible方法即可，例如配合 Flask-Login 只允许登录用户进入：

def is_accessible(self): return current_user.is_authenticated()

没有权限的用户不仅进不了页面，连菜单项都不会显示——非常适合做基于策略的细粒度权限控制。

企业官网建设流程全解析