starlette 开发环境配置的核心步骤是创建虚拟环境、安装依赖并编写入口文件。具体做法是使用 python -m venv 隔离环境,通过 pip install starlette uvicorn 安装核心库与 asgi 服务器,最后运行 uvicorn main:app 启动服务。

如何安装 Starlette 及其依赖
在本地环境中安装 Starlette 需要借助包管理工具 pip。首先确保已安装 Python 3.7+,然后使用 pip 将 starlette 和作为服务器的 uvicorn 安装到当前环境。这一步解决了代码运行所需的第三方库依赖问题。

pip install starlette uvicorn
安装完成后,可以通过导入模块来验证是否成功。如果 import starlette 不报错,说明环境配置正确。此时可以开始编写第一个应用。
如何编写并运行第一个 Starlette 应用
编写一个最小化的 Starlette 应用只需定义一个 Starlette 实例并添加路由。创建一个名为 main.py 的文件,在其中实例化应用对象,并使用装饰器或 add_route 方法绑定 URL 路径和处理函数。这是构建 Web 服务的起点。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

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)
保存文件后,在终端执行 uvicorn main:app 命令。该命令告诉 Uvicorn 从 main 模块中加载 app 对象。启动成功后,访问 http://localhost:8000 即可看到返回的文本内容。
修改代码后如何自动重启服务
在开发过程中,手动重启服务非常繁琐。Uvicorn 提供了 --reload 参数来实现热重载功能。当检测到源代码文件发生变化时,服务器会自动重启并加载最新代码。这极大地提高了调试效率。
uvicorn main:app --reload
使用该参数后,无需再次输入命令。只需保存 main.py 中的更改,刷新浏览器即可看到效果。注意在生产环境中不应启用此选项,因为它会增加资源开销且不适合高并发场景。

















