@@ -199,7 +199,7 @@ async def read_item(item_id: int, q: str | None = None):
**Note**:
-如果你不确定，请查看文档中 _"In a hurry?"_ 章节的
部分。
+如果你不确定，请查看文档中 _"In a hurry?"_ 章节的 [`async` 和 `await`](https://fastapi.tiangolo.com/zh/async/#in-a-hurry) 部分。
@@ -210,7 +210,7 @@ async def read_item(item_id: int, q: str | None = None):
```console
-$ fastapi dev main.py
+$ fastapi dev
╭────────── FastAPI CLI - Development mode ───────────╮
│ │
@@ -235,19 +235,19 @@ INFO: Application startup complete.
。
+用浏览器打开 [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 }
-现在访问
。
+现在访问 [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)。
-你会看到自动生成的交互式 API 文档（由
提供）：
+你会看到自动生成的交互式 API 文档（由 [Swagger UI](https://github.com/swagger-api/swagger-ui) 提供）：
### 可选的 API 文档 { #alternative-api-docs }
-然后访问
。
+然后访问 [http://127.0.0.1:8000/redoc](http://127.0.0.1:8000/redoc)。
-你会看到另一个自动生成的文档（由
提供）：
+你会看到另一个自动生成的文档（由 [ReDoc](https://github.com/Rebilly/ReDoc) 提供）：
@@ -316,7 +316,7 @@ def update_item(item_id: int, item: Item):
### 交互式 API 文档升级 { #interactive-api-docs-upgrade }
-现在访问
。
+现在访问 [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 }
-再访问
。
+再访问 [http://127.0.0.1:8000/redoc](http://127.0.0.1:8000/redoc)。
* 可选文档同样会体现新的查询参数和请求体：
@@ -442,7 +442,7 @@ item: Item
* 功能强大且易用的 **
** 系统。
* 安全与认证，包括对 **OAuth2**、**JWT tokens** 和 **HTTP Basic** 认证的支持。
* 更高级（但同样简单）的 **多层嵌套 JSON 模型** 声明技巧（得益于 Pydantic）。
-* 通过
等库进行 **GraphQL** 集成。
+* 通过 [Strawberry](https://strawberry.rocks) 等库进行 **GraphQL** 集成。
* 许多额外特性（归功于 Starlette），例如：
* **WebSockets**
* 基于 HTTPX 和 `pytest` 的极其简单的测试
@@ -452,24 +452,10 @@ item: Item
### 部署你的应用（可选） { #deploy-your-app-optional }
-你可以选择把 FastAPI 应用部署到
，如果还没有的话去加入候补名单吧。🚀
+你可以选择把 FastAPI 应用部署到 [FastAPI Cloud](https://fastapicloud.com)，如果还没有的话去加入候补名单吧。🚀
如果你已经有 **FastAPI Cloud** 账号（我们从候补名单邀请了你 😉），你可以用一个命令部署你的应用。
-部署前，先确认已登录：
-
-
```console
@@ -488,7 +474,7 @@ Deploying to FastAPI Cloud...
#### 关于 FastAPI Cloud { #about-fastapi-cloud }
-**
FastAPI Cloud** 由 **FastAPI** 的同一位作者和团队打造。
+**[FastAPI Cloud](https://fastapicloud.com)** 由 **FastAPI** 的同一位作者和团队打造。
它让你以最小的工作量就能**构建**、**部署**并**访问**一个 API。
@@ -504,9 +490,9 @@ FastAPI 是开源且基于标准的。你可以部署 FastAPI 应用到你选择
## 性能 { #performance }
-独立机构 TechEmpower 的基准测试显示，运行在 Uvicorn 下的 **FastAPI** 应用是
最快的 Python 框架之一，仅次于 Starlette 和 Uvicorn 本身（FastAPI 内部使用它们）。(*)
+独立机构 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 内部使用它们）。(*)
-想了解更多，请参阅
基准测试章节。
+想了解更多，请参阅 [基准测试](https://fastapi.tiangolo.com/zh/benchmarks/) 章节。
## 依赖项 { #dependencies }
@@ -518,19 +504,19 @@ FastAPI 依赖 Pydantic 和 Starlette。
Pydantic 使用：
-*
email-validator - 用于 email 校验。
+* [`email-validator`](https://github.com/JoshData/python-email-validator) - 用于 email 校验。
Starlette 使用：
-*
httpx - 使用 `TestClient` 时需要。
-*
jinja2 - 使用默认模板配置时需要。
-*
python-multipart - 使用 `request.form()` 支持表单
「解析」时需要。
+* [`httpx`](https://www.python-httpx.org) - 使用 `TestClient` 时需要。
+* [`jinja2`](https://jinja.palletsprojects.com) - 使用默认模板配置时需要。
+* [`python-multipart`](https://github.com/Kludex/python-multipart) - 使用 `request.form()` 支持表单
「解析」时需要。
FastAPI 使用：
-*
uvicorn - 加载并提供你的应用的服务器。包含 `uvicorn[standard]`，其中包含高性能服务所需的一些依赖（例如 `uvloop`）。
+* [`uvicorn`](https://www.uvicorn.dev) - 加载并提供你的应用的服务器。包含 `uvicorn[standard]`，其中包含高性能服务所需的一些依赖（例如 `uvloop`）。
* `fastapi-cli[standard]` - 提供 `fastapi` 命令。
- * 其中包含 `fastapi-cloud-cli`，它允许你将 FastAPI 应用部署到
FastAPI Cloud。
+ * 其中包含 `fastapi-cloud-cli`，它允许你将 FastAPI 应用部署到 [FastAPI Cloud](https://fastapicloud.com)。
### 不包含 `standard` 依赖 { #without-standard-dependencies }
@@ -546,13 +532,13 @@ FastAPI 使用：
额外的 Pydantic 可选依赖：
-*
pydantic-settings - 用于配置管理。
-*
pydantic-extra-types - 用于在 Pydantic 中使用的额外类型。
+* [`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 可选依赖：
-*
orjson - 使用 `ORJSONResponse` 时需要。
-*
ujson - 使用 `UJSONResponse` 时需要。
+* [`orjson`](https://github.com/ijl/orjson) - 使用 `ORJSONResponse` 时需要。
+* [`ujson`](https://github.com/esnme/ultrajson) - 使用 `UJSONResponse` 时需要。
## 许可协议 { #license }
diff --git a/docs/zh/docs/project-generation.md b/docs/zh/docs/project-generation.md
index a6ad9f94ac..8cc50c0963 100644
--- a/docs/zh/docs/project-generation.md
+++ b/docs/zh/docs/project-generation.md
@@ -4,7 +4,7 @@
你可以使用此模板开始，它已经为你完成了大量的初始设置、安全性、数据库以及一些 API 端点。
-GitHub 仓库：
Full Stack FastAPI Template
+GitHub 仓库：[Full Stack FastAPI Template](https://github.com/tiangolo/full-stack-fastapi-template)
## FastAPI全栈模板 - 技术栈和特性 { #full-stack-fastapi-template-technology-stack-and-features }
diff --git a/docs/zh/docs/python-types.md b/docs/zh/docs/python-types.md
index 4824b7558d..9b2fceb98e 100644
--- a/docs/zh/docs/python-types.md
+++ b/docs/zh/docs/python-types.md
@@ -269,7 +269,7 @@ def some_function(data: Any):
## Pydantic 模型 { #pydantic-models }
-
Pydantic 是一个用于执行数据校验的 Python 库。
+[Pydantic](https://docs.pydantic.dev/) 是一个用于执行数据校验的 Python 库。
你将数据的“结构”声明为带有属性的类。
@@ -285,13 +285,13 @@ def some_function(data: Any):
/// info | 信息
-想了解更多关于
Pydantic 的信息，请查看其文档。
+想了解更多关于 [Pydantic](https://docs.pydantic.dev/) 的信息，请查看其文档。
///
**FastAPI** 完全建立在 Pydantic 之上。
-你会在[教程 - 用户指南](tutorial/index.md){.internal-link target=_blank}中看到更多的实战示例。
+你会在[教程 - 用户指南](tutorial/index.md)中看到更多的实战示例。
## 带元数据注解的类型提示 { #type-hints-with-metadata-annotations }
@@ -337,12 +337,12 @@ Python 本身不会对这个 `Annotated` 做任何处理。对于编辑器和其
* 使用 OpenAPI 记录 API：
* 然后用于自动生成交互式文档界面。
-这些听起来可能有点抽象。别担心。你会在[教程 - 用户指南](tutorial/index.md){.internal-link target=_blank}中看到所有这些的实际效果。
+这些听起来可能有点抽象。别担心。你会在[教程 - 用户指南](tutorial/index.md)中看到所有这些的实际效果。
重要的是，通过使用标准的 Python 类型，而且只在一个地方声明（而不是添加更多类、装饰器等），**FastAPI** 会为你完成大量工作。
/// info | 信息
-如果你已经读完所有教程，又回来想进一步了解类型，一个不错的资源是
`mypy` 的“速查表”。
+如果你已经读完所有教程，又回来想进一步了解类型，一个不错的资源是 [`mypy` 的“速查表”](https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html)。
///
diff --git a/docs/zh/docs/tutorial/bigger-applications.md b/docs/zh/docs/tutorial/bigger-applications.md
index a667d596f8..74522f8384 100644
--- a/docs/zh/docs/tutorial/bigger-applications.md
+++ b/docs/zh/docs/tutorial/bigger-applications.md
@@ -123,7 +123,7 @@ from app.routers import items
我们正在使用虚构的请求首部来简化此示例。
-但在实际情况下，使用集成的[安全性实用工具](security/index.md){.internal-link target=_blank}会得到更好的效果。
+但在实际情况下，使用集成的[安全性实用工具](security/index.md)会得到更好的效果。
///
@@ -169,7 +169,7 @@ async def read_item(item_id: str):
/// tip | 提示
-请注意，和[*路径操作装饰器*中的依赖项](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}很类似，没有值会被传递给你的*路径操作函数*。
+请注意，和[*路径操作装饰器*中的依赖项](dependencies/dependencies-in-path-operation-decorators.md)很类似，没有值会被传递给你的*路径操作函数*。
///
@@ -185,8 +185,8 @@ async def read_item(item_id: str):
* 所有的路径操作都将包含预定义的 `responses`。
* 所有的这些*路径操作*都将在自身之前计算/执行 `dependencies` 列表。
* 如果你还在一个具体的*路径操作*中声明了依赖项，**它们也会被执行**。
- * 路由器的依赖项最先执行，然后是[装饰器中的 `dependencies`](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}，再然后是普通的参数依赖项。
- * 你还可以添加[具有 `scopes` 的 `Security` 依赖项](../advanced/security/oauth2-scopes.md){.internal-link target=_blank}。
+ * 路由器的依赖项最先执行，然后是[装饰器中的 `dependencies`](dependencies/dependencies-in-path-operation-decorators.md)，再然后是普通的参数依赖项。
+ * 你还可以添加[具有 `scopes` 的 `Security` 依赖项](../advanced/security/oauth2-scopes.md)。
/// tip | 提示
@@ -303,7 +303,7 @@ from ...dependencies import get_token_header
你可以像平常一样导入并创建一个 `FastAPI` 类。
-我们甚至可以声明[全局依赖项](dependencies/global-dependencies.md){.internal-link target=_blank}，它会和每个 `APIRouter` 的依赖项组合在一起：
+我们甚至可以声明[全局依赖项](dependencies/global-dependencies.md)，它会和每个 `APIRouter` 的依赖项组合在一起：
{* ../../docs_src/bigger_applications/app_an_py310/main.py hl[1,3,7] title["app/main.py"] *}
@@ -353,7 +353,7 @@ from .routers import items, users
from app.routers import items, users
```
-要了解有关 Python 包和模块的更多信息，请查阅
关于 Modules 的 Python 官方文档。
+要了解有关 Python 包和模块的更多信息，请查阅[关于 Modules 的 Python 官方文档](https://docs.python.org/3/tutorial/modules.html)。
///
@@ -451,7 +451,7 @@ from .routers.users import router
它将与通过 `app.include_router()` 添加的所有其他*路径操作*一起正常运行。
-/// info | 特别的技术细节
+/// info | 非常技术细节
**注意**：这是一个非常技术性的细节，你也许可以**直接跳过**。
@@ -465,6 +465,37 @@ from .routers.users import router
///
+## 在 `pyproject.toml` 中配置 `entrypoint` { #configure-the-entrypoint-in-pyproject-toml }
+
+因为你的 FastAPI `app` 对象位于 `app/main.py` 中，你可以在 `pyproject.toml` 中这样配置 `entrypoint`：
+
+```toml
+[tool.fastapi]
+entrypoint = "app.main:app"
+```
+
+等价于像这样导入：
+
+```python
+from app.main import app
+```
+
+这样 `fastapi` 命令就知道到哪里去找到你的应用了。
+
+/// Note | 注意
+
+你也可以把路径传给命令，比如：
+
+```console
+$ fastapi dev app/main.py
+```
+
+但是每次调用 `fastapi` 命令时，你都需要记得传入正确的路径。
+
+另外，其他工具可能找不到它，比如 [VS Code 扩展](../editor-support.md) 或 [FastAPI Cloud](https://fastapicloud.com)，因此推荐在 `pyproject.toml` 中使用 `entrypoint`。
+
+///
+
## 查看自动化的 API 文档 { #check-the-automatic-api-docs }
现在，运行你的应用：
@@ -472,14 +503,14 @@ from .routers.users import router
```console
-$ fastapi dev app/main.py
+$ fastapi dev
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```
-然后打开位于
http://127.0.0.1:8000/docs 的文档。
+然后打开位于 [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs) 的文档。
你将看到使用了正确路径（和前缀）和正确标签的自动化 API 文档，包括了来自所有子模块的路径：
diff --git a/docs/zh/docs/tutorial/body-updates.md b/docs/zh/docs/tutorial/body-updates.md
index 000201de99..5b181642cb 100644
--- a/docs/zh/docs/tutorial/body-updates.md
+++ b/docs/zh/docs/tutorial/body-updates.md
@@ -2,7 +2,7 @@
## 用 `PUT` 替换式更新 { #update-replacing-with-put }
-更新数据可以使用
HTTP `PUT` 操作。
+更新数据可以使用 [HTTP `PUT`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) 操作。
把输入数据转换为以 JSON 格式存储的数据（比如，使用 NoSQL 数据库时），可以使用 `jsonable_encoder`。例如，把 `datetime` 转换为 `str`。
@@ -28,7 +28,7 @@
## 用 `PATCH` 进行部分更新 { #partial-updates-with-patch }
-也可以使用
HTTP `PATCH` 操作对数据进行*部分*更新。
+也可以使用 [HTTP `PATCH`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH) 操作对数据进行*部分*更新。
也就是说，你只需发送想要更新的数据，其余数据保持不变。
@@ -95,6 +95,6 @@
因此，如果希望接收的部分更新可以省略所有属性，则需要一个所有属性都标记为可选（带默认值或 `None`）的模型。
-为了区分用于**更新**（全部可选）和用于**创建**（必填）的模型，可以参考[更多模型](extra-models.md){.internal-link target=_blank} 中介绍的思路。
+为了区分用于**更新**（全部可选）和用于**创建**（必填）的模型，可以参考[更多模型](extra-models.md) 中介绍的思路。
///
diff --git a/docs/zh/docs/tutorial/cors.md b/docs/zh/docs/tutorial/cors.md
index 2e271ec758..ebea43edba 100644
--- a/docs/zh/docs/tutorial/cors.md
+++ b/docs/zh/docs/tutorial/cors.md
@@ -1,6 +1,6 @@
# CORS（跨域资源共享） { #cors-cross-origin-resource-sharing }
-
CORS 或者「跨域资源共享」 指浏览器中运行的前端拥有与后端通信的 JavaScript 代码，而后端处于与前端不同的「源」的情况。
+[CORS 或者「跨域资源共享」](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 指浏览器中运行的前端拥有与后端通信的 JavaScript 代码，而后端处于与前端不同的「源」的情况。
## 源 { #origin }
@@ -55,10 +55,10 @@
* `allow_origins` - 一个允许跨域请求的源列表。例如 `['https://example.org', 'https://www.example.org']`。你可以使用 `['*']` 允许任何源。
* `allow_origin_regex` - 一个正则表达式字符串，匹配的源允许跨域请求。例如 `'https://.*\.example\.org'`。
* `allow_methods` - 一个允许跨域请求的 HTTP 方法列表。默认为 `['GET']`。你可以使用 `['*']` 来允许所有标准方法。
-* `allow_headers` - 一个允许跨域请求的 HTTP 请求头列表。默认为 `[]`。你可以使用 `['*']` 允许所有的请求头。`Accept`、`Accept-Language`、`Content-Language` 以及 `Content-Type` 这几个请求头在
简单 CORS 请求中总是被允许。
+* `allow_headers` - 一个允许跨域请求的 HTTP 请求头列表。默认为 `[]`。你可以使用 `['*']` 允许所有的请求头。`Accept`、`Accept-Language`、`Content-Language` 以及 `Content-Type` 这几个请求头在[简单 CORS 请求](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#simple_requests)中总是被允许。
* `allow_credentials` - 指示跨域请求支持 cookies。默认是 `False`。
- 当 `allow_credentials` 设为 `True` 时，`allow_origins`、`allow_methods` 和 `allow_headers` 都不能设为 `['*']`。它们必须
显式指定。
+ 当 `allow_credentials` 设为 `True` 时，`allow_origins`、`allow_methods` 和 `allow_headers` 都不能设为 `['*']`。它们必须[显式指定](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#credentialed_requests_and_wildcards)。
* `expose_headers` - 指示可以被浏览器访问的响应头。默认为 `[]`。
* `max_age` - 设定浏览器缓存 CORS 响应的最长时间，单位是秒。默认为 `600`。
@@ -77,7 +77,7 @@
## 更多信息 { #more-info }
-更多关于
CORS 的信息，请查看
Mozilla CORS 文档。
+更多关于
CORS 的信息，请查看 [Mozilla CORS 文档](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)。
/// note | 技术细节
diff --git a/docs/zh/docs/tutorial/debugging.md b/docs/zh/docs/tutorial/debugging.md
index 1ff7d61275..19e6f8a612 100644
--- a/docs/zh/docs/tutorial/debugging.md
+++ b/docs/zh/docs/tutorial/debugging.md
@@ -70,7 +70,7 @@ from myapp import app
/// info | 信息
-更多信息请检查
Python 官方文档.
+更多信息请检查 [Python 官方文档](https://docs.python.org/3/library/__main__.html).
///
diff --git a/docs/zh/docs/tutorial/encoder.md b/docs/zh/docs/tutorial/encoder.md
index 88be497493..8327ab6c7c 100644
--- a/docs/zh/docs/tutorial/encoder.md
+++ b/docs/zh/docs/tutorial/encoder.md
@@ -12,7 +12,7 @@
例如，它不接收`datetime`这类的对象，因为这些对象与JSON不兼容。
-因此，`datetime`对象必须转换为包含
ISO 格式的`str`类型对象。
+因此，`datetime`对象必须转换为包含[ISO 格式](https://en.wikipedia.org/wiki/ISO_8601)的`str`类型对象。
同样，这个数据库也不会接收Pydantic模型（带有属性的对象），而只接收`dict`。
@@ -24,7 +24,7 @@
在这个例子中，它将Pydantic模型转换为`dict`，并将`datetime`转换为`str`。
-调用它的结果后就可以使用Python标准编码中的
`json.dumps()`。
+调用它的结果后就可以使用Python标准编码中的[`json.dumps()`](https://docs.python.org/3/library/json.html#json.dumps)。
这个操作不会返回一个包含JSON格式（作为字符串）数据的庞大的`str`。它将返回一个Python标准数据结构（例如`dict`），其值和子值都与JSON兼容。
diff --git a/docs/zh/docs/tutorial/extra-data-types.md b/docs/zh/docs/tutorial/extra-data-types.md
index 2cefd163d3..76748a7a38 100644
--- a/docs/zh/docs/tutorial/extra-data-types.md
+++ b/docs/zh/docs/tutorial/extra-data-types.md
@@ -36,7 +36,7 @@
* `datetime.timedelta`:
* 一个 Python `datetime.timedelta`.
* 在请求和响应中将表示为 `float` 代表总秒数。
- * Pydantic 也允许将其表示为 "ISO 8601 时间差异编码",
查看文档了解更多信息。
+ * Pydantic 也允许将其表示为 "ISO 8601 时间差异编码", [查看文档了解更多信息](https://docs.pydantic.dev/latest/concepts/serialization/#custom-serializers)。
* `frozenset`:
* 在请求和响应中，作为 `set` 对待：
* 在请求中，列表将被读取，消除重复，并将其转换为一个 `set`。
@@ -49,7 +49,7 @@
* `Decimal`:
* 标准的 Python `Decimal`。
* 在请求和响应中被当做 `float` 一样处理。
-* 您可以在这里检查所有有效的 Pydantic 数据类型:
Pydantic data types.
+* 您可以在这里检查所有有效的 Pydantic 数据类型: [Pydantic data types](https://docs.pydantic.dev/latest/usage/types/types/)。
## 例子 { #example }
diff --git a/docs/zh/docs/tutorial/extra-models.md b/docs/zh/docs/tutorial/extra-models.md
index 09baa47319..8b6b790b8e 100644
--- a/docs/zh/docs/tutorial/extra-models.md
+++ b/docs/zh/docs/tutorial/extra-models.md
@@ -108,7 +108,7 @@ UserInDB(**user_dict)
UserInDB(**user_in.model_dump())
```
-……因为 `user_in.model_dump()` 是 `dict`，在传递给 `UserInDB` 时，把 `**` 加在 `user_in.model_dump()` 前，可以让 Python 进行解包。
+...因为 `user_in.model_dump()` 是 `dict`，在传递给 `UserInDB` 时，把 `**` 加在 `user_in.model_dump()` 前，可以让 Python 进行解包。
这样，就可以用其它 Pydantic 模型中的数据生成 Pydantic 模型。
@@ -120,7 +120,7 @@ UserInDB(**user_in.model_dump())
UserInDB(**user_in.model_dump(), hashed_password=hashed_password)
```
-……输出结果如下：
+...输出结果如下：
```Python
UserInDB(
@@ -162,11 +162,11 @@ UserInDB(
在 OpenAPI 中会用 `anyOf` 表示。
-为此，请使用 Python 标准类型提示
`typing.Union`：
+为此，请使用 Python 标准类型提示 [`typing.Union`](https://docs.python.org/3/library/typing.html#typing.Union)：
/// note | 注意
-定义
`Union` 类型时，要把更具体的类型写在前面，然后是不太具体的类型。下例中，更具体的 `PlaneItem` 位于 `Union[PlaneItem, CarItem]` 中的 `CarItem` 之前。
+定义 [`Union`](https://docs.pydantic.dev/latest/concepts/types/#unions) 类型时，要把更具体的类型写在前面，然后是不太具体的类型。下例中，更具体的 `PlaneItem` 位于 `Union[PlaneItem, CarItem]` 中的 `CarItem` 之前。
///
diff --git a/docs/zh/docs/tutorial/first-steps.md b/docs/zh/docs/tutorial/first-steps.md
index 4c23807b8f..3fbab4d9b3 100644
--- a/docs/zh/docs/tutorial/first-steps.md
+++ b/docs/zh/docs/tutorial/first-steps.md
@@ -11,7 +11,7 @@
```console
-$
fastapi dev
main.py
+$
fastapi dev
FastAPI Starting development server 🚀
@@ -58,7 +58,7 @@ INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
### 查看 { #check-it }
-打开浏览器访问
http://127.0.0.1:8000。
+打开浏览器访问 [http://127.0.0.1:8000](http://127.0.0.1:8000)。
你将看到如下的 JSON 响应：
@@ -68,17 +68,17 @@ INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
### 交互式 API 文档 { #interactive-api-docs }
-跳转到
http://127.0.0.1:8000/docs。
+跳转到 [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)。
-你将会看到自动生成的交互式 API 文档（由
Swagger UI 提供）：
+你将会看到自动生成的交互式 API 文档（由 [Swagger UI](https://github.com/swagger-api/swagger-ui) 提供）：
### 可选的 API 文档 { #alternative-api-docs }
-前往
http://127.0.0.1:8000/redoc。
+前往 [http://127.0.0.1:8000/redoc](http://127.0.0.1:8000/redoc)。
-你将会看到可选的自动生成文档 （由
ReDoc 提供）：
+你将会看到可选的自动生成文档 （由 [ReDoc](https://github.com/Rebilly/ReDoc) 提供）：
@@ -92,7 +92,7 @@ INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
#### API「模式」 { #api-schema }
-在这种场景下，
OpenAPI 是一种规定如何定义 API 模式的规范。
+在这种场景下，[OpenAPI](https://github.com/OAI/OpenAPI-Specification) 是一种规定如何定义 API 模式的规范。
「模式」的定义包括你的 API 路径，以及它们可能使用的参数等等。
@@ -110,7 +110,7 @@ OpenAPI 为你的 API 定义 API 模式。该模式中包含了你的 API 发送
如果你对原始的 OpenAPI 模式长什么样子感到好奇，FastAPI 自动生成了包含所有 API 描述的 JSON（模式）。
-你可以直接在：
http://127.0.0.1:8000/openapi.json 看到它。
+你可以直接在：[http://127.0.0.1:8000/openapi.json](http://127.0.0.1:8000/openapi.json) 看到它。
它将显示以如下内容开头的 JSON：
@@ -143,9 +143,58 @@ OpenAPI 为你的 API 定义 API 模式。该模式中包含了你的 API 发送
你还可以使用它自动生成与你的 API 进行通信的客户端代码。例如 web 前端，移动端或物联网嵌入程序。
+### 在 `pyproject.toml` 中配置应用 `entrypoint` { #configure-the-app-entrypoint-in-pyproject-toml }
+
+你可以在 `pyproject.toml` 文件中配置应用的位置，例如：
+
+```toml
+[tool.fastapi]
+entrypoint = "main:app"
+```
+
+该 `entrypoint` 会告诉 `fastapi` 命令按如下方式导入应用：
+
+```python
+from main import app
+```
+
+如果你的代码结构如下：
+
+```
+.
+├── backend
+│ ├── main.py
+│ ├── __init__.py
+```
+
+那么你可以将 `entrypoint` 设置为：
+
+```toml
+[tool.fastapi]
+entrypoint = "backend.main:app"
+```
+
+这等价于：
+
+```python
+from backend.main import app
+```
+
+### `fastapi dev` 带路径 { #fastapi-dev-with-path }
+
+你也可以把文件路径传给 `fastapi dev` 命令，它会尝试推断要使用的 FastAPI 应用对象：
+
+```console
+$ fastapi dev main.py
+```
+
+但这样每次调用 `fastapi` 命令时都需要记得传入正确的路径。
+
+另外，其他工具可能无法找到它，例如 [VS Code 扩展](../editor-support.md) 或 [FastAPI Cloud](https://fastapicloud.com)，因此推荐在 `pyproject.toml` 中使用 `entrypoint`。
+
### 部署你的应用（可选） { #deploy-your-app-optional }
-你可以选择将 FastAPI 应用部署到
FastAPI Cloud，如果还没有，先去加入候补名单。🚀
+你可以选择将 FastAPI 应用部署到 [FastAPI Cloud](https://fastapicloud.com)，如果还没有，先去加入候补名单。🚀
如果你已经拥有 **FastAPI Cloud** 账户（我们从候补名单邀请了你 😉），你可以用一条命令部署应用。
@@ -191,7 +240,7 @@ Deploying to FastAPI Cloud...
`FastAPI` 是直接从 `Starlette` 继承的类。
-你可以通过 `FastAPI` 使用所有的
Starlette 的功能。
+你可以通过 `FastAPI` 使用所有的 [Starlette](https://www.starlette.dev/) 的功能。
///
@@ -273,7 +322,7 @@ https://example.com/items/foo
* 请求路径为 `/`
* 使用
get 操作
-/// info | `@decorator` Info
+/// info | `@decorator` 信息
`@something` 语法在 Python 中被称为「装饰器」。
@@ -352,11 +401,11 @@ https://example.com/items/foo
### 步骤 6：部署 { #step-6-deploy-it }
-用一条命令将你的应用部署到 **
FastAPI Cloud**：`fastapi deploy`。🎉
+用一条命令将你的应用部署到 **[FastAPI Cloud](https://fastapicloud.com)**：`fastapi deploy`。🎉
#### 关于 FastAPI Cloud { #about-fastapi-cloud }
-**
FastAPI Cloud** 由 **FastAPI** 的作者和团队打造。
+**[FastAPI Cloud](https://fastapicloud.com)** 由 **FastAPI** 的作者和团队打造。
它以最小的投入简化了 **构建**、**部署** 和 **访问** API 的流程。
diff --git a/docs/zh/docs/tutorial/handling-errors.md b/docs/zh/docs/tutorial/handling-errors.md
index 9782f3d225..f3a23fab0a 100644
--- a/docs/zh/docs/tutorial/handling-errors.md
+++ b/docs/zh/docs/tutorial/handling-errors.md
@@ -81,7 +81,7 @@
## 安装自定义异常处理器 { #install-custom-exception-handlers }
-可以使用
与 Starlette 相同的异常处理工具添加自定义异常处理器。
+可以使用[与 Starlette 相同的异常处理工具](https://www.starlette.dev/exceptions/)添加自定义异常处理器。
假设有一个自定义异常 `UnicornException`（你自己或你使用的库可能会 `raise` 它）。
diff --git a/docs/zh/docs/tutorial/index.md b/docs/zh/docs/tutorial/index.md
index 7934583023..8d6cbc7a6d 100644
--- a/docs/zh/docs/tutorial/index.md
+++ b/docs/zh/docs/tutorial/index.md
@@ -10,12 +10,12 @@
所有代码片段都可以复制后直接使用（它们实际上是经过测试的 Python 文件）。
-要运行任何示例，请将代码复制到 `main.py` 文件中，然后使用以下命令启动 `fastapi dev`：
+要运行任何示例，请将代码复制到 `main.py` 文件中，然后启动 `fastapi dev`：
```console
-$
fastapi dev
main.py
+$
fastapi dev
FastAPI Starting development server 🚀
@@ -62,7 +62,7 @@ $
fastapi dev
@@ -76,7 +76,7 @@ $ pip install "fastapi[standard]"
/// note | 注意
-当您使用 `pip install "fastapi[standard]"` 安装时，它会附带一些默认的可选标准依赖项，其中包括 `fastapi-cloud-cli`，它可以让您部署到 FastAPI Cloud。
+当您使用 `pip install "fastapi[standard]"` 安装时，它会附带一些默认的可选标准依赖项，其中包括 `fastapi-cloud-cli`，它可以让您部署到 [FastAPI Cloud](https://fastapicloud.com)。
如果您不想安装这些可选依赖，可以选择安装 `pip install fastapi`。
@@ -84,6 +84,12 @@ $ pip install "fastapi[standard]"
///
+/// tip | 提示
+
+FastAPI 提供了一个[VS Code 官方扩展](https://marketplace.visualstudio.com/items?itemName=FastAPILabs.fastapi-vscode)（也支持 Cursor），包含众多功能，例如路径操作浏览器、路径操作搜索、测试中的 CodeLens 导航（从测试跳转到定义），以及从编辑器内进行 FastAPI Cloud 部署和查看日志。
+
+///
+
## 进阶用户指南 { #advanced-user-guide }
在本**教程-用户指南**之后，您可以阅读**进阶用户指南**。
diff --git a/docs/zh/docs/tutorial/middleware.md b/docs/zh/docs/tutorial/middleware.md
index a211a63bdf..e7586132f2 100644
--- a/docs/zh/docs/tutorial/middleware.md
+++ b/docs/zh/docs/tutorial/middleware.md
@@ -15,7 +15,7 @@
如果你有使用 `yield` 的依赖，依赖中的退出代码会在中间件之后运行。
-如果有任何后台任务（会在[后台任务](background-tasks.md){.internal-link target=_blank}一节中介绍，你稍后会看到），它们会在所有中间件之后运行。
+如果有任何后台任务（会在[后台任务](background-tasks.md)一节中介绍，你稍后会看到），它们会在所有中间件之后运行。
///
@@ -35,9 +35,9 @@
/// tip
-请记住可以使用 `X-` 前缀添加专有自定义请求头。
+请记住可以[使用 `X-` 前缀](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)添加专有自定义请求头。
-但是如果你有希望让浏览器中的客户端可见的自定义请求头，你需要把它们加到你的 CORS 配置（[CORS (Cross-Origin Resource Sharing)](cors.md){.internal-link target=_blank}）的 `expose_headers` 参数中，参见 Starlette 的 CORS 文档。
+但是如果你有希望让浏览器中的客户端可见的自定义请求头，你需要把它们加到你的 CORS 配置（[CORS（跨域资源共享）](cors.md)）的 `expose_headers` 参数中，参见 [Starlette 的 CORS 文档](https://www.starlette.dev/middleware/#corsmiddleware)。
///
@@ -61,7 +61,7 @@
/// tip
-这里我们使用 `time.perf_counter()` 而不是 `time.time()`，因为在这类场景中它可能更精确。🤓
+这里我们使用 [`time.perf_counter()`](https://docs.python.org/3/library/time.html#time.perf_counter) 而不是 `time.time()`，因为在这类场景中它可能更精确。🤓
///
@@ -90,6 +90,6 @@ app.add_middleware(MiddlewareB)
## 其他中间件 { #other-middlewares }
-你可以稍后在[高级用户指南：高级中间件](../advanced/middleware.md){.internal-link target=_blank}中阅读更多关于其他中间件的内容。
+你可以稍后在[高级用户指南：高级中间件](../advanced/middleware.md)中阅读更多关于其他中间件的内容。
你将在下一节中了解如何使用中间件处理 CORS。
diff --git a/docs/zh/docs/tutorial/path-params.md b/docs/zh/docs/tutorial/path-params.md
index 06a9f1b442..df9210673c 100644
--- a/docs/zh/docs/tutorial/path-params.md
+++ b/docs/zh/docs/tutorial/path-params.md
@@ -6,7 +6,7 @@
路径参数 `item_id` 的值会作为参数 `item_id` 传递给你的函数。
-运行示例并访问 http://127.0.0.1:8000/items/foo，可获得如下响应：
+运行示例并访问 [http://127.0.0.1:8000/items/foo](http://127.0.0.1:8000/items/foo)，可获得如下响应：
```JSON
{"item_id":"foo"}
@@ -28,7 +28,7 @@
## 数据转换 { #data-conversion }
-运行示例并访问 http://127.0.0.1:8000/items/3，返回的响应如下：
+运行示例并访问 [http://127.0.0.1:8000/items/3](http://127.0.0.1:8000/items/3)，返回的响应如下：
```JSON
{"item_id":3}
@@ -44,7 +44,7 @@
## 数据校验 { #data-validation }
-通过浏览器访问 http://127.0.0.1:8000/items/foo，接收如下 HTTP 错误信息：
+通过浏览器访问 [http://127.0.0.1:8000/items/foo](http://127.0.0.1:8000/items/foo)，接收如下 HTTP 错误信息：
```JSON
{
@@ -64,7 +64,7 @@
这是因为路径参数 `item_id` 的值（`"foo"`）的类型不是 `int`。
-值的类型不是 `int` 而是浮点数（`float`）时也会显示同样的错误，比如： http://127.0.0.1:8000/items/4.2
+值的类型不是 `int` 而是浮点数（`float`）时也会显示同样的错误，比如： [http://127.0.0.1:8000/items/4.2](http://127.0.0.1:8000/items/4.2)
/// check | 检查
@@ -78,7 +78,7 @@
## 文档 { #documentation }
-访问 http://127.0.0.1:8000/docs，查看自动生成的交互式 API 文档：
+访问 [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)，查看自动生成的交互式 API 文档：
@@ -92,9 +92,9 @@
## 基于标准的好处，备选文档 { #standards-based-benefits-alternative-documentation }
-**FastAPI** 使用 OpenAPI 生成概图，所以能兼容很多工具。
+**FastAPI** 使用 [OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md) 生成概图，所以能兼容很多工具。
-因此，**FastAPI** 还内置了 ReDoc 生成的备选 API 文档，可在此查看 http://127.0.0.1:8000/redoc：
+因此，**FastAPI** 还内置了 ReDoc 生成的备选 API 文档，可在此查看 [http://127.0.0.1:8000/redoc](http://127.0.0.1:8000/redoc)：
@@ -102,7 +102,7 @@
## Pydantic { #pydantic }
-FastAPI 充分地利用了 Pydantic 的优势，用它在后台校验数据。众所周知，Pydantic 擅长的就是数据校验。
+FastAPI 充分地利用了 [Pydantic](https://docs.pydantic.dev/) 的优势，用它在后台校验数据。众所周知，Pydantic 擅长的就是数据校验。
同样，`str`、`float`、`bool` 以及很多复合数据类型都可以使用类型声明。
diff --git a/docs/zh/docs/tutorial/query-params-str-validations.md b/docs/zh/docs/tutorial/query-params-str-validations.md
index d41f302267..67a5b40008 100644
--- a/docs/zh/docs/tutorial/query-params-str-validations.md
+++ b/docs/zh/docs/tutorial/query-params-str-validations.md
@@ -35,13 +35,13 @@ FastAPI 在 0.95.0 版本中添加了对 `Annotated` 的支持（并开始推荐
如果你的版本更旧，使用 `Annotated` 会报错。
-在使用 `Annotated` 之前，请确保先[升级 FastAPI 版本](../deployment/versions.md#upgrading-the-fastapi-versions){.internal-link target=_blank}到至少 0.95.1。
+在使用 `Annotated` 之前，请确保先[升级 FastAPI 版本](../deployment/versions.md#upgrading-the-fastapi-versions)到至少 0.95.1。
///
## 在 `q` 参数的类型中使用 `Annotated` { #use-annotated-in-the-type-for-the-q-parameter }
-还记得我之前在[Python 类型简介](../python-types.md#type-hints-with-metadata-annotations){.internal-link target=_blank}中说过可以用 `Annotated` 给参数添加元数据吗？
+还记得我之前在[Python 类型简介](../python-types.md#type-hints-with-metadata-annotations)中说过可以用 `Annotated` 给参数添加元数据吗？
现在正是与 FastAPI 搭配使用它的时候。🚀
@@ -105,7 +105,7 @@ FastAPI 现在会：
q: str | None = Query(default=None)
```
-……会让参数变成可选，默认值为 `None`，等同于：
+...会让参数变成可选，默认值为 `None`，等同于：
```Python
q: str | None = None
@@ -133,7 +133,7 @@ q: str | None = Query(default=None, max_length=50)
q: Annotated[str, Query(default="rick")] = "morty"
```
-……因为不清楚默认值应该是 `"rick"` 还是 `"morty"`。
+...因为不清楚默认值应该是 `"rick"` 还是 `"morty"`。
因此，你应该这样用（推荐）：
@@ -141,7 +141,7 @@ q: Annotated[str, Query(default="rick")] = "morty"
q: Annotated[str, Query()] = "rick"
```
-……或者在旧代码库中你会见到：
+...或者在旧代码库中你会见到：
```Python
q: str = Query(default="rick")
@@ -157,7 +157,7 @@ q: str = Query(default="rick")
当你不使用 `Annotated` 而是使用**（旧的）默认值风格**时，如果你在**其他地方**不通过 FastAPI 调用该函数，你必须**记得**给函数传参，否则得到的值会和预期不同（例如得到 `QueryInfo` 之类的对象而不是 `str`）。而你的编辑器不会报错，Python 也不会在调用时报错，只有在函数内部的操作出错时才会暴露问题。
-由于 `Annotated` 可以包含多个元数据标注，你甚至可以用同一个函数与其他工具配合，例如 Typer。🚀
+由于 `Annotated` 可以包含多个元数据标注，你甚至可以用同一个函数与其他工具配合，例如 [Typer](https://typer.tiangolo.com/)。🚀
## 添加更多校验 { #add-more-validations }
@@ -337,7 +337,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
最接近的有效名称是 `item_query`。
-但你仍然需要它在 URL 中就是 `item-query`……
+但你仍然需要它在 URL 中就是 `item-query`...
这时可以用 `alias` 参数声明一个别名，FastAPI 会用该别名在 URL 中查找参数值：
@@ -369,11 +369,11 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
在这些情况下，你可以使用**自定义校验函数**，该函数会在正常校验之后应用（例如，在先校验值是 `str` 之后）。
-你可以在 `Annotated` 中使用 Pydantic 的 `AfterValidator` 来实现。
+你可以在 `Annotated` 中使用 [Pydantic 的 `AfterValidator`](https://docs.pydantic.dev/latest/concepts/validators/#field-after-validator) 来实现。
/// tip | 提示
-Pydantic 还有 `BeforeValidator` 等。🤓
+Pydantic 还有 [`BeforeValidator`](https://docs.pydantic.dev/latest/concepts/validators/#field-before-validator) 等。🤓
///
@@ -421,7 +421,7 @@ Pydantic 还有 `python-multipart`。
+要使用表单，首先安装 [`python-multipart`](https://github.com/Kludex/python-multipart)。
-请先创建并激活一个[虚拟环境](../virtual-environments.md){.internal-link target=_blank}，然后再进行安装，例如：
+请先创建并激活一个[虚拟环境](../virtual-environments.md)，然后再进行安装，例如：
```console
$ pip install python-multipart
@@ -28,7 +28,7 @@ $ pip install python-multipart
例如，在 OAuth2 规范的一种使用方式（称为“密码流”）中，要求将 `username` 和 `password` 作为表单字段发送。
-规范 要求这些字段必须精确命名为 `username` 和 `password`，并且作为表单字段发送，而不是 JSON。
+规范要求这些字段必须精确命名为 `username` 和 `password`，并且作为表单字段发送，而不是 JSON。
使用 `Form` 可以像使用 `Body`（以及 `Query`、`Path`、`Cookie`）一样声明相同的配置，包括校验、示例、别名（例如将 `username` 写成 `user-name`）等。
@@ -56,7 +56,7 @@ HTML 表单（``）向服务器发送数据时通常会对数据使
但当表单包含文件时，会编码为 `multipart/form-data`。你将在下一章阅读如何处理文件。
-如果你想了解更多关于这些编码和表单字段的信息，请参阅 MDN Web 文档的 POST。
+如果你想了解更多关于这些编码和表单字段的信息，请参阅 [MDN Web 文档的 `POST`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST)。
///
diff --git a/docs/zh/docs/tutorial/response-model.md b/docs/zh/docs/tutorial/response-model.md
index df0afa66f8..9b4e0382e9 100644
--- a/docs/zh/docs/tutorial/response-model.md
+++ b/docs/zh/docs/tutorial/response-model.md
@@ -13,6 +13,7 @@ FastAPI 会使用这个返回类型来：
* 在 OpenAPI 的*路径操作*中为响应添加**JSON Schema**。
* 它会被**自动文档**使用。
* 它也会被自动客户端代码生成工具使用。
+* 使用 Pydantic 将返回数据**序列化**为 JSON。Pydantic 使用**Rust**编写，因此会**快很多**。
但更重要的是：
@@ -73,9 +74,9 @@ FastAPI 会使用这个 `response_model` 来完成数据文档、校验等，并
/// info | 信息
-要使用 `EmailStr`，首先安装 `email-validator`。
+要使用 `EmailStr`，首先安装 [`email-validator`](https://github.com/JoshData/python-email-validator)。
-请先创建并激活一个[虚拟环境](../virtual-environments.md){.internal-link target=_blank}，然后安装，例如：
+请先创建并激活一个[虚拟环境](../virtual-environments.md)，然后安装，例如：
```console
$ pip install email-validator
@@ -181,7 +182,7 @@ FastAPI 在内部配合 Pydantic 做了多项处理，确保不会把类继承
### 直接返回 Response { #return-a-response-directly }
-最常见的情况是[直接返回 Response，详见进阶文档](../advanced/response-directly.md){.internal-link target=_blank}。
+最常见的情况是[直接返回 Response，详见进阶文档](../advanced/response-directly.md)。
{* ../../docs_src/response_model/tutorial003_02_py310.py hl[8,10:11] *}
@@ -257,7 +258,7 @@ FastAPI 在内部配合 Pydantic 做了多项处理，确保不会把类继承
* `response_model_exclude_defaults=True`
* `response_model_exclude_none=True`
-详见 Pydantic 文档中对 `exclude_defaults` 和 `exclude_none` 的说明。
+详见 [Pydantic 文档](https://docs.pydantic.dev/1.10/usage/exporting_models/#modeldict)中对 `exclude_defaults` 和 `exclude_none` 的说明。
///
diff --git a/docs/zh/docs/tutorial/response-status-code.md b/docs/zh/docs/tutorial/response-status-code.md
index 266f919ba1..e57c0e5937 100644
--- a/docs/zh/docs/tutorial/response-status-code.md
+++ b/docs/zh/docs/tutorial/response-status-code.md
@@ -20,7 +20,7 @@
/// info | 信息
-`status_code` 还能接收 `IntEnum` 类型，比如 Python 的 `http.HTTPStatus`。
+`status_code` 还能接收 `IntEnum` 类型，比如 Python 的 [`http.HTTPStatus`](https://docs.python.org/3/library/http.html#http.HTTPStatus)。
///
@@ -66,7 +66,7 @@ FastAPI 可以进行识别，并生成表明无响应体的 OpenAPI 文档。
/// tip | 提示
-状态码及适用场景的详情，请参阅 MDN 的 HTTP 状态码文档。
+想了解每个状态码的更多信息以及适用场景，请参阅 [MDN 的 HTTP 状态码文档](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status)。
///
@@ -98,4 +98,4 @@ FastAPI 可以进行识别，并生成表明无响应体的 OpenAPI 文档。
## 更改默认状态码 { #changing-the-default }
-[高级用户指南](../advanced/response-change-status-code.md){.internal-link target=_blank}中，将介绍如何返回与在此声明的默认状态码不同的状态码。
+稍后在[高级用户指南](../advanced/response-change-status-code.md)中，你将看到如何返回与此处声明的默认状态码不同的状态码。
diff --git a/docs/zh/docs/virtual-environments.md b/docs/zh/docs/virtual-environments.md
index 60fb9e23f6..14ee538639 100644
--- a/docs/zh/docs/virtual-environments.md
+++ b/docs/zh/docs/virtual-environments.md
@@ -22,7 +22,7 @@
这个页面将教你如何使用**虚拟环境**以及了解它们的工作原理。
-如果你计划使用一个**可以为你管理一切的工具**（包括安装 Python），试试 uv。
+如果你计划使用一个**可以为你管理一切的工具**（包括安装 Python），试试 [uv](https://github.com/astral-sh/uv)。
///
@@ -86,7 +86,7 @@ $ python -m venv .venv
//// tab | `uv`
-如果你安装了 `uv`，你也可以使用它来创建一个虚拟环境。
+如果你安装了 [`uv`](https://github.com/astral-sh/uv)，你也可以使用它来创建一个虚拟环境。
@@ -150,7 +150,7 @@ $ .venv\Scripts\Activate.ps1
//// tab | Windows Bash
-或者，如果你在 Windows 上使用 Bash（例如
Git Bash）：
+或者，如果你在 Windows 上使用 Bash（例如 [Git Bash](https://gitforwindows.org/)）：
@@ -216,7 +216,7 @@ C:\Users\user\code\awesome-project\.venv\Scripts\python
/// tip | 提示
-如果你使用
`uv` 来安装内容，而不是 `pip`，那么你就不需要升级 `pip`。😎
+如果你使用 [`uv`](https://github.com/astral-sh/uv) 来安装内容，而不是 `pip`，那么你就不需要升级 `pip`。😎
///
@@ -268,7 +268,7 @@ $ python -m ensurepip --upgrade
/// tip | 提示
-如果你使用
`uv` 来创建虚拟环境，它会自动为你完成这个操作，你可以跳过这一步。😎
+如果你使用 [`uv`](https://github.com/astral-sh/uv) 来创建虚拟环境，它会自动为你完成这个操作，你可以跳过这一步。😎
///
@@ -340,7 +340,7 @@ $ pip install "fastapi[standard]"
//// tab | `uv`
-如果你有
`uv`:
+如果你有 [`uv`](https://github.com/astral-sh/uv):
@@ -372,7 +372,7 @@ $ pip install -r requirements.txt
//// tab | `uv`
-如果你有
`uv`:
+如果你有 [`uv`](https://github.com/astral-sh/uv):
@@ -416,8 +416,8 @@ Hello World
例如：
-*
VS Code
-*
PyCharm
+* [VS Code](https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment)
+* [PyCharm](https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html)
/// tip | 提示
@@ -455,7 +455,7 @@ $ deactivate
## 为什么要使用虚拟环境 { #why-virtual-environments }
-你需要安装
Python 才能使用 FastAPI。
+你需要安装 [Python](https://www.python.org/) 才能使用 FastAPI。
之后，你需要**安装** FastAPI 和你想要使用的任何其他**软件包**。
@@ -564,7 +564,7 @@ $ pip install "fastapi[standard]"
-这将会从
PyPI 下载一个压缩文件，其中包含 FastAPI 代码。
+这将会从 [PyPI](https://pypi.org/project/fastapi/) 下载一个压缩文件，其中包含 FastAPI 代码。
它还会**下载** FastAPI 依赖的其他软件包的文件。
@@ -627,7 +627,7 @@ $ .venv\Scripts\Activate.ps1
//// tab | Windows Bash
-或者如果你在 Windows 上使用 Bash（例如
Git Bash）：
+或者如果你在 Windows 上使用 Bash（例如 [Git Bash](https://gitforwindows.org/)）：
@@ -639,13 +639,13 @@ $ source .venv/Scripts/activate
////
-这个命令会创建或修改一些[环境变量](environment-variables.md){.internal-link target=_blank}，这些环境变量将在接下来的命令中可用。
+这个命令会创建或修改一些[环境变量](environment-variables.md)，这些环境变量将在接下来的命令中可用。
其中之一是 `PATH` 变量。
/// tip | 提示
-你可以在 [环境变量](environment-variables.md#path-environment-variable){.internal-link target=_blank} 部分了解更多关于 `PATH` 环境变量的内容。
+你可以在 [环境变量](environment-variables.md#path-environment-variable) 部分了解更多关于 `PATH` 环境变量的内容。
///
@@ -846,7 +846,7 @@ I solemnly swear 🐺
有许多**替代方案**来管理虚拟环境、包依赖（requirements）、工程。
-一旦你准备好并想要使用一个工具来**管理整个工程**、包依赖、虚拟环境等，建议你尝试
uv。
+一旦你准备好并想要使用一个工具来**管理整个工程**、包依赖、虚拟环境等，建议你尝试 [uv](https://github.com/astral-sh/uv)。
`uv` 可以做很多事情，它可以：
+
+
+
