@ -11,25 +11,25 @@
< em > FastAPI 框架，高性能，易于学习，高效编码，生产可用< / em >
< / p >
< p align = "center" >
< a href = "https://github.com/fastapi/fastapi/actions?query=workflow%3ATest+event%3Apush+branch%3Amaster" target = "_blank" >
< a href = "https://github.com/fastapi/fastapi/actions?query=workflow%3ATest+event%3Apush+branch%3Amaster" >
< img src = "https://github.com/fastapi/fastapi/actions/workflows/test.yml/badge.svg?event=push&branch=master" alt = "Test" >
< / a >
< a href = "https://coverage-badge.samuelcolvin.workers.dev/redirect/fastapi/fastapi" target = "_blank" >
< a href = "https://coverage-badge.samuelcolvin.workers.dev/redirect/fastapi/fastapi" >
< img src = "https://coverage-badge.samuelcolvin.workers.dev/fastapi/fastapi.svg" alt = "Coverage" >
< / a >
< a href = "https://pypi.org/project/fastapi" target = "_blank" >
< a href = "https://pypi.org/project/fastapi" >
< img src = "https://img.shields.io/pypi/v/fastapi?color=%2334D058&label=pypi%20package" alt = "Package version" >
< / a >
< a href = "https://pypi.org/project/fastapi" target = "_blank" >
< a href = "https://pypi.org/project/fastapi" >
< img src = "https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt = "Supported Python versions" >
< / a >
< / p >
---
**文档**： < a href = "https://fastapi.tiangolo.com/zh" target = "_blank" > https://fastapi.tiangolo.com< / a >
**文档**： [https://fastapi.tiangolo.com/zh ](https://fastapi.tiangolo.com/zh )
**源码**： < a href = "https://github.com/fastapi/fastapi" target = "_blank" > https://github.com/fastapi/fastapi< / a >
**源码**： [https://github.com/fastapi/fastapi ](https://github.com/fastapi/fastapi )
---
@ -44,7 +44,7 @@ FastAPI 是一个用于构建 API 的现代、快速（高性能）的 Web 框
* **易用** ：为易用和易学而设计。更少的文档阅读时间。
* **简短** ：最小化代码重复。一次参数声明即可获得多种功能。更少的 bug。
* **健壮** ：生产可用级代码。并带有自动生成的交互式文档。
* **标准化** ：基于（并完全兼容）API 的开放标准：< a href = "https://github.com/OAI/OpenAPI-Specification" class = "external-link" target = "_blank" > OpenAPI</ a > （以前称为 Swagger）和 < a href = "https://json-schema.org/" class = "external-link" target = "_blank" > JSON Schema</ a >
* **标准化** ：基于（并完全兼容）API 的开放标准：[OpenAPI](https://github.com/OAI/OpenAPI-Specification)（以前称为 Swagger）和 [JSON Schema ](https://json-schema.org/ ) 。
< small > * 基于某内部开发团队在构建生产应用时的测试估算。< / small >
@ -55,51 +55,51 @@ FastAPI 是一个用于构建 API 的现代、快速（高性能）的 Web 框
### Keystone 赞助商 { #keystone -sponsor }
{% for sponsor in sponsors.keystone -%}
< a href = "{{ sponsor.url }}" target = "_blank" t itle = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
< a href = "{{ sponsor.url }}" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
{% endfor -%}
### 金牌和银牌赞助商 { #gold -and-silver-sponsors }
{% for sponsor in sponsors.gold -%}
< a href = "{{ sponsor.url }}" target = "_blank" t itle = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
< a href = "{{ sponsor.url }}" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
{% endfor -%}
{%- for sponsor in sponsors.silver -%}
< a href = "{{ sponsor.url }}" target = "_blank" t itle = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
< a href = "{{ sponsor.url }}" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
{% endfor %}
<!-- /sponsors -->
< a href = "https://fastapi.tiangolo.com/zh/fastapi-people/#sponsors" class = "external-link" target = "_blank" > 其他赞助商< / a >
[其他赞助商 ](https://fastapi.tiangolo.com/zh/fastapi-people/#sponsors )
## 评价 { #opinions }
「_[...] 最近我大量使用 **FastAPI** 。[...] 我实际上计划把它用于我团队在 **微软** 的所有 **机器学习服务** 。其中一些正在集成进核心 **Windows** 产品以及一些 **Office** 产品。_」
< div style = "text-align: right; margin-right: 10%;" > Kabir Khan - < strong > Microsoft< / strong > < a href = "https://github.com/fastapi/fastapi/pull/26" target = "_blank" > < small > (ref)< / small > < / a > < / div >
< div style = "text-align: right; margin-right: 10%;" > Kabir Khan - < strong > Microsoft< / strong > < a href = "https://github.com/fastapi/fastapi/pull/26" > < small > (ref)< / small > < / a > < / div >
---
「_我们采用 **FastAPI** 来构建可查询以获取**预测结果**的 **REST** 服务器。[用于 Ludwig]_」
< div style = "text-align: right; margin-right: 10%;" > Piero Molino，Yaroslav Dudin，Sai Sumanth Miryala - < strong > Uber< / strong > < a href = "https://eng.uber.com/ludwig-v0-2/" target = "_blank" > < small > (ref)< / small > < / a > < / div >
< div style = "text-align: right; margin-right: 10%;" > Piero Molino，Yaroslav Dudin，Sai Sumanth Miryala - < strong > Uber< / strong > < a href = "https://eng.uber.com/ludwig-v0-2/" > < small > (ref)< / small > < / a > < / div >
---
「_**Netflix** 很高兴宣布开源我们的**危机管理**编排框架：**Dispatch**！[使用 **FastAPI** 构建]_」
< div style = "text-align: right; margin-right: 10%;" > Kevin Glisson，Marc Vilanova，Forest Monsen - < strong > Netflix< / strong > < a href = "https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target = "_blank" > < small > (ref)< / small > < / a > < / div >
< div style = "text-align: right; margin-right: 10%;" > Kevin Glisson，Marc Vilanova，Forest Monsen - < strong > Netflix< / strong > < a href = "https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" > < small > (ref)< / small > < / a > < / div >
---
「_我对 **FastAPI** 兴奋到飞起。它太有趣了！_」
< div style = "text-align: right; margin-right: 10%;" > Brian Okken - < strong > < a href = "https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target = "_blank" > Python Bytes< / a > < / strong > < a href = "https://x.com/brianokken/status/1112220079972728832" target = "_blank " > < small > (ref)< / small > < / a > < / div >
< div style = "text-align: right; margin-right: 10%;" > Brian Okken - < strong > [Python Bytes](https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855) 播客主持人< / strong > < a href = "https://x.com/brianokken/status/1112220079972728832" > < small > (ref)< / small > < / a > < / div >
---
「_老实说，你构建的东西非常稳健而且打磨得很好。从很多方面看，这就是我想让 **Hug** 成为的样子 —— 看到有人把它做出来真的很鼓舞人心。_」
< div style = "text-align: right; margin-right: 10%;" > Timothy Crosley - < strong > < a href = "https://github.com/hugapi/hug" target = "_blank" > Hug< / a > < / strong > < a href = "https://news.ycombinator.com/item?id=19455465" target = "_blank " > < small > (ref)< / small > < / a > < / div >
< div style = "text-align: right; margin-right: 10%;" > Timothy Crosley - < strong > [Hug](https://github.com/hugapi/hug) 作者< / strong > < a href = "https://news.ycombinator.com/item?id=19455465" > < small > (ref)< / small > < / a > < / div >
---
@ -107,27 +107,27 @@ FastAPI 是一个用于构建 API 的现代、快速（高性能）的 Web 框
「_我们已经把我们的 **API** 切换到 **FastAPI** [...] 我想你会喜欢它 [...]_」
< div style = "text-align: right; margin-right: 10%;" > Ines Montani - Matthew Honnibal - < strong > < a href = "https://explosion.ai" target = "_blank" > Explosion AI< / a > 创始人 - < a href = "https://spacy.io" target = "_blank" > spaCy< / a > 作者< / strong > < a href = "https://x.com/_inesmontani/status/1144173225322143744" target = "_blank" > < small > (ref)< / small > < / a > - < a href = "https://x.com/honnibal/status/1144031421859655680" target = "_blank" > < small > (ref)< / small > < / a > < / div >
< div style = "text-align: right; margin-right: 10%;" > Ines Montani - Matthew Honnibal - < strong > [Explosion AI](https://explosion.ai) 创始人 - [spaCy ](https://spacy.io ) 作者< /strong > < a href = "https://x.com/_inesmontani/status/1144173225322143744" >< small > (ref)</ small ></ a > - < a href = "https://x.com/honnibal/status/1144031421859655680" >< small > (ref)</ small ></ a ></ div >
---
「_如果有人正在构建生产级的 Python API，我强烈推荐 **FastAPI** 。它**设计优雅**、**使用简单**且**高度可扩展**，已经成为我们 API 优先开发战略中的**关键组件**，并驱动了许多自动化和服务，比如我们的 Virtual TAC Engineer。_」
< div style = "text-align: right; margin-right: 10%;" > Deon Pillsbury - < strong > Cisco< / strong > < a href = "https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target = "_blank" > < small > (ref)< / small > < / a > < / div >
< div style = "text-align: right; margin-right: 10%;" > Deon Pillsbury - < strong > Cisco< / strong > < a href = "https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" > < small > (ref)< / small > < / a > < / div >
---
## FastAPI 迷你纪录片 { #fastapi -mini-documentary }
在 2025 年末发布了一部< a href = "https://www.youtube.com/watch?v=mpR8ngthqiE" class = "external-link" target = "_blank" > FastAPI 迷你纪录片< / a >
在 2025 年末发布了一部 [FastAPI 迷你纪录片 ](https://www.youtube.com/watch?v=mpR8ngthqiE ) ，你可以在线观看：
< a href = "https://www.youtube.com/watch?v=mpR8ngthqiE" target = "_blank" > < img src = "https://fastapi.tiangolo.com/img/fastapi-documentary.jpg" alt = "FastAPI Mini Documentary" > < / a >
< a href = "https://www.youtube.com/watch?v=mpR8ngthqiE" > < img src = "https://fastapi.tiangolo.com/img/fastapi-documentary.jpg" alt = "FastAPI Mini Documentary" > < / a >
## **Typer** ，命令行中的 FastAPI { #typer -the-fastapi-of-clis }
< a href = "https://typer.tiangolo.com" target = "_blank" > < img src = "https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style = "width: 20%;" > < / a >
< a href = "https://typer.tiangolo.com" > < img src = "https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style = "width: 20%;" > < / a >
如果你要开发一个用于终端的 < abbr title = "Command Line Interface" > 命令行< / abbr > 应用而不是 Web API，看看 < a href = "https://typer.tiangolo.com/" class = "external-link" target = "_blank" > **Typer**< / a >
如果你要开发一个用于终端的 < abbr title = "Command Line Interface - 命令行界面 " > 命令行</ abbr > 应用而不是 Web API，看看 [**Typer** ](https://typer.tiangolo.com/ ) 。
**Typer** 是 FastAPI 的小同胞。它的目标是成为**命令行中的 FastAPI**。⌨️ 🚀
@ -135,12 +135,12 @@ FastAPI 是一个用于构建 API 的现代、快速（高性能）的 Web 框
FastAPI 站在巨人的肩膀之上：
* < a href = "https://www.starlette.dev/" class = "external-link" target = "_blank" > Starlette< / a >
* < a href = "https://docs.pydantic.dev/" class = "external-link" target = "_blank" > Pydantic< / a >
* [Starlette ](https://www.starlette.dev/ ) 负责 Web 部分。
* [Pydantic ](https://docs.pydantic.dev/ ) 负责数据部分。
## 安装 { #installation }
创建并激活一个< a href = "https://fastapi.tiangolo.com/zh/virtual-environments/" class = "external-link" target = "_blank" > 虚拟环境< / a >
创建并激活一个 [虚拟环境 ](https://fastapi.tiangolo.com/zh/virtual-environments/ ) ，然后安装 FastAPI：
< div class = "termy" >
@ -199,7 +199,7 @@ async def read_item(item_id: int, q: str | None = None):
**Note**:
如果你不确定，请查看文档中 _"In a hurry?"_ 章节的< a href = "https://fastapi.tiangolo.com/zh/async/#in-a-hurry" target = "_blank" > `async` 和 `await` </ a >
如果你不确定，请查看文档中 _"In a hurry?"_ 章节的 [`async` 和 `await` ](https://fastapi.tiangolo.com/zh/async/#in-a-hurry ) 部分。
< / details >
@ -210,7 +210,7 @@ async def read_item(item_id: int, q: str | None = None):
< div class = "termy" >
```console
$ fastapi dev main.py
$ fastapi dev
╭────────── FastAPI CLI - Development mode ───────────╮
│ │
@ -235,19 +235,19 @@ INFO: Application startup complete.
< / div >
< details markdown = "1" >
< summary > 关于命令 < code > fastapi dev main.py < / code > ...< / summary >
< summary > 关于命令 < code > fastapi dev< / code > ...< / summary >
`fastapi dev` 命令会读取你的 `main.py` 文件，检测其中的 **FastAPI** 应用，并使用 < a href = "https://www.uvicorn.dev" class = "external-link" target = "_blank" > Uvicorn</ a >
`fastapi dev` 命令会读取你的 `main.py` 文件，检测其中的 **FastAPI** 应用，并使用 [Uvicorn ](https://www.uvicorn.dev ) 启动服务器。
默认情况下，`fastapi dev` 会在本地开发时启用自动重载。
你可以在 < a href = "https://fastapi.tiangolo.com/zh/fastapi-cli/" target = "_blank" > FastAPI CLI 文档< / a >
你可以在 [FastAPI CLI 文档 ](https://fastapi.tiangolo.com/zh/fastapi-cli/ ) 中了解更多。
< / details >
### 检查 { #check -it }
用浏览器打开 < a href = "http://127.0.0.1:8000/items/5?q=somequery" class = "external-link" target = "_blank" > http://127.0.0.1:8000/items/5?q=somequery< / a >
用浏览器打开 [http://127.0.0.1:8000/items/5?q=somequery ](http://127.0.0.1:8000/items/5?q=somequery ) 。
你会看到如下 JSON 响应：
@ -264,17 +264,17 @@ INFO: Application startup complete.
### 交互式 API 文档 { #interactive -api-docs }
现在访问 < a href = "http://127.0.0.1:8000/docs" class = "external-link" target = "_blank" > http://127.0.0.1:8000/docs< / a >
现在访问 [http://127.0.0.1:8000/docs ](http://127.0.0.1:8000/docs ) 。
你会看到自动生成的交互式 API 文档（由 < a href = "https://github.com/swagger-api/swagger-ui" class = "external-link" target = "_blank" > Swagger UI< / a >
你会看到自动生成的交互式 API 文档（由 [Swagger UI ](https://github.com/swagger-api/swagger-ui ) 提供）：
### 可选的 API 文档 { #alternative -api-docs }
然后访问 < a href = "http://127.0.0.1:8000/redoc" class = "external-link" target = "_blank" > http://127.0.0.1:8000/redoc< / a >
然后访问 [http://127.0.0.1:8000/redoc ](http://127.0.0.1:8000/redoc ) 。
你会看到另一个自动生成的文档（由 < a href = "https://github.com/Rebilly/ReDoc" class = "external-link" target = "_blank" > ReDoc< / a >
你会看到另一个自动生成的文档（由 [ReDoc ](https://github.com/Rebilly/ReDoc ) 提供）：
@ -316,7 +316,7 @@ def update_item(item_id: int, item: Item):
### 交互式 API 文档升级 { #interactive -api-docs-upgrade }
现在访问 < a href = "http://127.0.0.1:8000/docs" class = "external-link" target = "_blank" > http://127.0.0.1:8000/docs< / a >
现在访问 [http://127.0.0.1:8000/docs ](http://127.0.0.1:8000/docs ) 。
* 交互式 API 文档会自动更新，并包含新的请求体：
@ -332,7 +332,7 @@ def update_item(item_id: int, item: Item):
### 可选文档升级 { #alternative -api-docs-upgrade }
再访问 < a href = "http://127.0.0.1:8000/redoc" class = "external-link" target = "_blank" > http://127.0.0.1:8000/redoc< / a >
再访问 [http://127.0.0.1:8000/redoc ](http://127.0.0.1:8000/redoc ) 。
* 可选文档同样会体现新的查询参数和请求体：
@ -442,7 +442,7 @@ item: Item
* 功能强大且易用的 ** < dfn title = "也被称为：组件、资源、提供者、服务、可注入项" > 依赖注入</ dfn > ** 系统。
* 安全与认证，包括对 **OAuth2** 、**JWT tokens** 和 **HTTP Basic** 认证的支持。
* 更高级（但同样简单）的 **多层嵌套 JSON 模型** 声明技巧（得益于 Pydantic）。
* 通过 < a href = "https://strawberry.rocks" class = "external-link" target = "_blank" > Strawberry</ a > **GraphQL** 集成。
* 通过 [Strawberry ](https://strawberry.rocks ) 等库进行 **GraphQL** 集成。
* 许多额外特性（归功于 Starlette），例如：
* * *WebSockets**
* 基于 HTTPX 和 `pytest` 的极其简单的测试
@ -452,24 +452,10 @@ item: Item
### 部署你的应用（可选） { #deploy -your-app-optional }
你可以选择把 FastAPI 应用部署到 < a href = "https://fastapicloud.com" class = "external-link" target = "_blank" > FastAPI Cloud< / a >
你可以选择把 FastAPI 应用部署到 [FastAPI Cloud ](https://fastapicloud.com ) ，如果还没有的话去加入候补名单吧。🚀
如果你已经有 **FastAPI Cloud** 账号（我们从候补名单邀请了你 😉），你可以用一个命令部署你的应用。
部署前，先确认已登录：
< div class = "termy" >
```console
$ fastapi login
You are logged in to FastAPI Cloud 🚀
```
< / div >
然后部署你的应用：
< div class = "termy" >
```console
@ -488,7 +474,7 @@ Deploying to FastAPI Cloud...
#### 关于 FastAPI Cloud { #about -fastapi-cloud }
**< a href = "https://fastapicloud.com" class = "external-link" target = "_blank" > FastAPI Cloud</ a > **FastAPI** 的同一位作者和团队打造。
**[FastAPI Cloud](https://fastapicloud.com) ** 由 **FastAPI** 的同一位作者和团队打造。
它让你以最小的工作量就能**构建**、**部署**并**访问**一个 API。
@ -504,9 +490,9 @@ FastAPI 是开源且基于标准的。你可以部署 FastAPI 应用到你选择
## 性能 { #performance }
独立机构 TechEmpower 的基准测试显示，运行在 Uvicorn 下的 **FastAPI** 应用是< a href = " https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class = "external-link" target = "_blank" > 最快的 Python 框架之一</ a >
独立机构 TechEmpower 的基准测试显示，运行在 Uvicorn 下的 **FastAPI** 应用是 [最快的 Python 框架之一 ]( https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7 ) ，仅次于 Starlette 和 Uvicorn 本身（FastAPI 内部使用它们）。(*)
想了解更多，请参阅< a href = "https://fastapi.tiangolo.com/zh/benchmarks/" class = "internal-link" target = "_blank" > 基准测试< / a >
想了解更多，请参阅 [基准测试 ](https://fastapi.tiangolo.com/zh/benchmarks/ ) 章节。
## 依赖项 { #dependencies }
@ -518,19 +504,19 @@ FastAPI 依赖 Pydantic 和 Starlette。
Pydantic 使用：
* < a href = "https://github.com/JoshData/python-email-validator" target = "_blank" > < code > email-validator< / code > < / a >
* [`email-validator` ](https://github.com/JoshData/python-email-validator ) - 用于 email 校验。
Starlette 使用：
* < a href = "https://www.python-httpx.org" target = "_blank" >< code > httpx</ code ></ a > `TestClient` 时需要。
* < a href = "https://jinja.palletsprojects.com" target = "_blank" > < code > jinja2< / code > < / a >
* < a href = "https://github.com/Kludex/python-multipart" target = "_blank" >< code > python-multipart</ code ></ a > `request.form()` 支持表单< dfn title = "将 HTTP 请求中的字符串转换为 Python 数据" > 「解析」</ dfn > 时需要。
* [`httpx` ](https://www.python-httpx.org ) - 使用 `TestClient` 时需要。
* [`jinja2` ](https://jinja.palletsprojects.com ) - 使用默认模板配置时需要。
* [`python-multipart` ](https://github.com/Kludex/python-multipart ) - 使用 `request.form()` 支持表单< dfn title = "将 HTTP 请求中的字符串转换为 Python 数据" > 「解析」</ dfn > 时需要。
FastAPI 使用：
* < a href = "https://www.uvicorn.dev" target = "_blank" >< code > uvicorn</ code ></ a > `uvicorn[standard]` ，其中包含高性能服务所需的一些依赖（例如 `uvloop` ）。
* [`uvicorn` ](https://www.uvicorn.dev ) - 加载并提供你的应用的服务器。包含 `uvicorn[standard]` ，其中包含高性能服务所需的一些依赖（例如 `uvloop` ）。
* `fastapi-cli[standard]` - 提供 `fastapi` 命令。
* 其中包含 `fastapi-cloud-cli` ，它允许你将 FastAPI 应用部署到 < a href = "https://fastapicloud.com" class = "external-link" target = "_blank" > FastAPI Cloud</ a >
* 其中包含 `fastapi-cloud-cli` ，它允许你将 FastAPI 应用部署到 [FastAPI Cloud ](https://fastapicloud.com ) 。
### 不包含 `standard` 依赖 { #without -standard-dependencies }
@ -546,13 +532,13 @@ FastAPI 使用：
额外的 Pydantic 可选依赖：
* < a href = "https://docs.pydantic.dev/latest/usage/pydantic_settings/" target = "_blank" > < code > pydantic-settings< / code > < / a >
* < a href = "https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/" target = "_blank" > < code > pydantic-extra-types< / code > < / a >
* [`pydantic-settings` ](https://docs.pydantic.dev/latest/usage/pydantic_settings/ ) - 用于配置管理。
* [`pydantic-extra-types` ](https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/ ) - 用于在 Pydantic 中使用的额外类型。
额外的 FastAPI 可选依赖：
* < a href = "https://github.com/ijl/orjson" target = "_blank" >< code > orjson</ code ></ a > `ORJSONResponse` 时需要。
* < a href = "https://github.com/esnme/ultrajson" target = "_blank" >< code > ujson</ code ></ a > `UJSONResponse` 时需要。
* [`orjson` ](https://github.com/ijl/orjson ) - 使用 `ORJSONResponse` 时需要。
* [`ujson` ](https://github.com/esnme/ultrajson ) - 使用 `UJSONResponse` 时需要。
## 许可协议 { #license }
github-actions[bot]
4 months ago
Yurii Motov