开发者博客

本节提供使用 starlette-admin 构建管理界面的高级模式与实用技巧。这些文章聚焦于真实场景中的实现，是对标准参考文档的进一步拓展。

受监督的机器翻译

本文内容由机器翻译生成，并遵循人工维护的术语表与风格指南。由于译文未经逐行人工审校，可能偶有错误或表达不当之处。

如有任何出入，请以英文原版为准，英文原版是权威来源。

使用 starlette-admin 在 5 分钟内为 FastAPI 添加管理后台

你的后端已经上线运行，但很快就需要非工程师来修改线上数据：修正某条记录里的错别字、下架一篇文章，或者查一下用户到底提交了什么。常见的变通做法往往并不理想：

方案	缺点
自建 CRUD 前端	构建和维护需要耗费数周的开发时间。
直接访问数据库	会带来巨大的安全和数据完整性风险。
Django Admin / Flask Admin	要么迫使你重写整个框架，要么依赖同步 WSGI，从而阻塞你的异步 ASGI 应用。
starlette-admin	零前端代码，即刻挂载到你的应用上。

starlette-admin 适用于任何基于 Starlette 的应用，而 FastAPI 恰好正是这样的应用。

本指南将带你从一个空文件开始，在 5 分钟内搭建出一套可用的后台管理系统。你将构建分页列表、搜索功能、可排序的列、由现有 Pydantic 模型校验的创建与编辑表单、删除确认以及 CSV 导出——所有这些都直接由一个 SQLAlchemy 模型生成。

受监督的机器翻译

本文内容由机器翻译生成，并遵循人工维护的术语表与风格指南。由于译文未经逐行人工审校，可能偶有错误或表达不当之处。

如有任何出入，请以英文原版为准，英文原版是权威来源。

标准的 DELETE 操作是不可挽回的。如果操作员误点了一下，或者某个自动化清理任务用错了过滤器，数据就会丢失，除非你执行一次复杂的数据库恢复。实现"软删除"可以缓解这一风险：它只是把记录标记为已删除，而不是将其从数据库中永久移除。这样一来，数据恢复就变成了一次简单的更新操作。

本指南演示如何在 FastAPI 应用中借助 starlette-admin 实现软删除模式。我们将构建一个完整的解决方案，其中用到：

查看完整的可运行代码：examples/advanced/01-soft-delete。