一、Starlette 是什么?
Starlette 是一个轻量级、高性能、异步优先的 Python Web 框架,专为构建异步 Web 应用和 API 设计。它不是 Django 那种大而全的框架,而是专注于提供核心的 Web 功能(路由、请求/响应处理、WebSocket、中间件等),设计理念是“模块化、可扩展、无冗余”,常被称为“异步版的 Flask”,也是 FastAPI 的核心底层依赖(FastAPI 基于 Starlette 构建,补充了 OpenAPI 文档、数据校验等功能)。
核心定位:
- 异步优先:基于 Python 3.7+ 的
async/await语法,原生支持异步 I/O,性能远优于传统同步框架。 - 轻量灵活:无强制依赖(仅依赖
anyio处理异步事件循环),可按需搭配其他库(如 ORM、模板引擎)。 - 功能完备:覆盖 Web 开发的核心场景(REST API、WebSocket、后台任务、测试工具等)。
二、核心特性(新手易懂版)
- 基础 Web 功能
- 路由系统:支持路径参数、正则匹配、路由分组,写法简洁。
- 请求/响应处理:原生支持 JSON、表单、文件上传,响应可返回字符串、JSON、流数据等。
- 中间件:内置常用中间件(CORS、会话、日志、异常处理),也可自定义。
- 异步能力
- 原生支持
async def定义视图函数,完美适配异步数据库(如 asyncpg)、异步 HTTP 客户端(如 httpx)。 - 支持 WebSocket 双向通信(异步),适合实时应用(如聊天、通知)。
- 原生支持
- 实用工具
- 后台任务:无需额外依赖即可实现异步后台任务(如发送邮件、数据处理)。
- 测试客户端:内置
TestClient,可直接模拟请求测试接口,无需启动服务器。 - 依赖注入:轻量的依赖系统,便于解耦和复用逻辑(FastAPI 在此基础上强化了这一功能)。
- 高性能
- 基于 ASGI(异步服务器网关接口),可搭配 Uvicorn、Hypercorn 等 ASGI 服务器运行,性能接近 Node.js 和 Go 编写的 Web 服务。
三、快速上手(极简示例)
1. 安装
首先安装 Starlette 和 ASGI 服务器(以 Uvicorn 为例):
pipinstallstarlette uvicorn2. 最小化应用
创建main.py:
fromstarlette.applicationsimportStarlettefromstarlette.responsesimportJSONResponsefromstarlette.routingimportRoute# 异步视图函数asyncdefhomepage(request):# 获取请求参数(示例:query参数)name=request.query_params.get("name","Guest")returnJSONResponse({"message":f"Hello,{name}!"})# 定义路由routes=[Route("/",endpoint=homepage,methods=["GET"]),]# 创建应用实例app=Starlette(debug=True,routes=routes)3. 运行应用
uvicorn main:app --reload访问http://127.0.0.1:8000?name=Python,会返回:
{"message":"Hello, Python!"}四、Starlette 的适用场景
- 构建高性能的异步 API 服务;
- 开发实时应用(WebSocket、Server-Sent Events);
- 作为底层框架扩展(如 FastAPI 基于它构建);
- 小型/中型项目(无需 Django 全家桶的场景)。
五、与其他框架的对比
| 框架 | 定位 | 核心优势 | 适合场景 |
|---|---|---|---|
| Starlette | 轻量异步 Web 框架 | 高性能、灵活、异步优先 | 异步 API、实时应用 |
| FastAPI | 基于 Starlette 的 API 框架 | 自动生成 OpenAPI 文档、数据校验 | 标准化 REST API 开发 |
| Flask | 同步轻量框架 | 生态丰富、学习成本低 | 小型同步应用、快速原型 |
| Django | 全栈同步框架 | 大而全、内置 admin/ORM | 复杂全栈应用、快速开发 |
总结
- Starlette 是异步优先、轻量高性能的 Python Web 框架,基于 ASGI 标准,核心功能聚焦且无冗余;
- 它的优势是异步能力强、灵活易扩展,是构建异步 API 和实时应用的优选;
- FastAPI 基于 Starlette 构建,补充了 API 文档、数据校验等功能,若需标准化 API 可优先选 FastAPI,若需极致灵活则选 Starlette。