Repolode
提交项目
litestar-org

litestar-org/litestar

一个灵活的 ASGI Python Web 框架，专注于构建 API，内置数据校验、依赖注入和 OpenAPI 文档生成。

在 GitHub 查看官网
Star
8,537
Fork
683
未关闭 Issue
364
最近提交
昨天

这是什么？

Litestar 是一个面向 API 开发的 Python ASGI 框架。它开箱提供了大多数 API 项目需要的能力：请求数据校验与序列化、依赖注入、中间件、用于授权的 Route Guards，以及插件系统。路由处理函数既可以是普通函数，也可以是基于类的 Controller，类型注解同时用于数据校验和生成 OpenAPI 3.1 规范。

框架支持 dataclasses、TypedDict、msgspec、pydantic（v1 和 v2）以及 attrs 模型。接口文档可通过 Scalar、ReDoc、Swagger-UI 和 Stoplight Elements 访问，默认全部启用。项目还内置 SQLAlchemy 插件，可以直接把 SQLAlchemy 模型用作请求和响应类型；基于 AnyIO，可在 asyncio 或 Trio 上运行。

可通过 pip 安装，使用 `litestar[standard]` 额外依赖即可获得命令行工具和 uvicorn 服务器。

核心功能

  • 01基于 Python 类型注解的请求数据校验与序列化。
  • 02支持同步或异步依赖注入，可在应用的不同层级定义和覆盖依赖。
  • 03提供用于授权的 Route Guards，以及 CORS、CSRF、限流、压缩等中间件。
  • 04自动生成 OpenAPI 3.1 规范，并提供 Scalar、ReDoc、Swagger-UI 等文档界面。
  • 05内置 SQLAlchemy 插件和 DTO 支持，兼容 pydantic、msgspec 和 attrs 模型。

适用场景

  • 用 Python 构建 JSON REST API，并自动生成 OpenAPI 文档。
  • 开发需要类型化请求校验和依赖注入的异步后端服务。
  • 通过带类型的路由处理函数直接暴露基于 SQLAlchemy 的数据。

快速上手

  1. 1

    使用 pip 安装 Litestar

    pip install litestar
  2. 2

    将 hello world 示例保存为 app.py

  3. 3

    运行应用

    litestar run

收录于专题

应用开发框架并发与异步编程库

标签

#python#asgi#api#rest-api#openapi#async#web-framework#dependency-injection#asyncio#litestar

常见问题

litestar 是什么？
一个灵活的 ASGI Python Web 框架，专注于构建 API，内置数据校验、依赖注入和 OpenAPI 文档生成。 Litestar 是一个面向 API 开发的 Python ASGI 框架。它开箱提供了大多数 API 项目需要的能力：请求数据校验与序列化、依赖注入、中间件、用于授权的 Route Guards，以及插件系统。路由处理函数既可以是普通函数，也可以是基于类的 Controller，类型注解同时用于数据校验和生成 OpenAPI 3.1 规范。
litestar 可以免费使用吗？用的什么许可证？
litestar 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
litestar 还在维护吗？
活跃维护中。litestar 最近一次提交是在 2026年11月6日。
litestar 适合用来做什么？
用 Python 构建 JSON REST API，并自动生成 OpenAPI 文档。 开发需要类型化请求校验和依赖注入的异步后端服务。 通过带类型的路由处理函数直接暴露基于 SQLAlchemy 的数据。
litestar 怎么安装和运行？
使用 pip 安装 Litestar: pip install litestar 将 hello world 示例保存为 app.py 运行应用: litestar run
在哪里获取 litestar？
源代码和安装说明在 GitHub 上：https://github.com/litestar-org/litestar

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目