starlette 框架的环境搭建与快速启动可以通过安装依赖库并编写一个包含路由和应用的 python 脚本来实现。具体做法是运行 pip install starlette uvicorn 安装核心组件,然后创建一个继承自 starlette 的实例,使用 @app.route() 装饰器定义处理函数,最后通过 uvicorn 命令行工具启动该应用。

如何安装 Starlette 及其依赖项
安装过程主要涉及两个包:框架本身和 ASGI 服务器。在终端中执行 pip install starlette uvicorn 即可完成环境配置。Starlette 负责路由和应用逻辑,而 Uvicorn 作为 ASGI 服务器负责将 HTTP 请求传递给 Starlette 应用。这两个包是开发基于 Starlette 的应用的基础,缺一不可。

import sys
sys.path.insert(0, '.')
from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def homepage(request):
return PlainTextResponse('Hello World!')
routes = [
Route('/', homepage),
]
app = Starlette(routes=routes)
如何编写并启动第一个 Starlette 应用
编写应用的核心在于创建 Starlette 实例并定义路由。代码中首先导入必要的类,接着定义一个异步函数 homepage 用于处理请求并返回文本响应。然后创建一个包含路由映射的列表,将根路径 / 绑定到 homepage 函数。最后实例化 Starlette 对象并将路由列表传入。启动应用时,在终端运行 uvicorn main:app,其中 main 是文件名,app 是应用实例名。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

uvicorn main:app --reload
当访问未定义的路径时应用会返回什么结果
如果用户访问未在 routes 列表中定义的路径,例如 /not-found,Starlette 默认会返回一个 404 Not Found 错误页面。这是因为 Starlette 实例在没有匹配到任何路由时,会自动触发默认的异常处理机制,向客户端发送标准的 404 状态码和 HTML 错误内容。开发者可以通过添加自定义的异常处理器来改变这一行为,但默认情况下即为 404 响应。










