starlette 是一个轻量级的 asgi 框架,安装配置只需通过 pip 安装核心包及一个 asgi 服务器(如 uvicorn),常用命令包括启动服务、运行测试和生成依赖。具体做法是执行 pip install starlette uvicorn,然后使用 uvicorn main:app --reload 启动开发服务器。

如何安装 Starlette 及其依赖的 ASGI 服务器?
安装 Starlette 本身非常简单,但因为它是一个纯 ASGI 框架,不包含内置的 HTTP 服务器,所以必须搭配一个 ASGI 服务器才能运行。最推荐的组合是 starlette 和 uvicorn。在终端中执行以下命令即可完成环境配置:
pip install starlette uvicorn
这条命令会下载并安装最新版本的 Starlette 库以及 Uvicorn 服务器。安装完成后,你可以创建一个名为 main.py 的文件来验证安装是否成功。文件中定义一个简单的应用实例,并通过 uvicorn 命令行工具启动它。这是排查安装问题最直接的方式,如果导入报错或服务器无法启动,通常意味着环境变量或包版本存在冲突。
Starlette 项目中常用的开发和调试命令有哪些?
在开发过程中,最常用的命令是启动带有热重载功能的服务器,以便在代码修改后自动重启。此外,还包括检查代码风格和管理依赖的命令。以下是具体的操作示例:
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
uvicorn main:app --reload --host 0.0.0.0 --port 8000
上述命令中,--reload 参数启用文件监控,--host 0.0.0.0 允许外部访问,--port 8000 指定端口。如果你需要检查代码是否符合 PEP 8 规范,可以使用 flake8 main.py。对于依赖管理,pip freeze > requirements.txt 可以将当前环境的所有包及其版本导出到文件中,便于部署时复现环境。这些命令构成了日常开发的基础工作流。
当 main.py 中定义了 App 实例但未调用 run 方法时,Uvicorn 如何识别入口?
Starlette 应用对象本身并不包含启动服务器的逻辑,它只是一个可调用对象。Uvicorn 通过命令行参数 main:app 来定位这个对象。其中 main 是模块名(即 main.py 去掉后缀),app 是该模块中定义的 Starlette 实例变量名。Uvicorn 会动态导入该模块并获取该属性,从而获得 ASGI 应用实例。这种设计解耦了应用逻辑与服务器启动逻辑,使得同一个应用可以部署在不同的 ASGI 服务器上,如 Gunicorn 配合 Uvicorn worker 或 Daphne。
为了验证这一机制,我们可以看一个简单的代码结构。在 main.py 中:
from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
async def homepage(request):
return PlainTextResponse('Hello!')
app = Starlette(routes=[...])
# 注意:这里没有 app.run() 或类似调用当你运行 uvicorn main:app 时,Uvicorn 内部执行类似 import main; application = main.app 的操作。如果变量名不是 app 而是 application,则命令需改为 uvicorn main:application。这种命名约定是 Starlette 生态中的标准实践,确保了工具链的一致性。

















