但在多數情況下，讀取檔案或類檔案物件會造成阻塞。

///

為了避免阻塞事件迴圈，你可以將路徑操作函式宣告為一般的 `def`（而非 `async def`），這樣 FastAPI 會在 threadpool worker 上執行它，避免阻塞主事件迴圈。

{* ../../docs_src/stream_data/tutorial002_py310.py ln[30:34] hl[31] *}

/// tip

如果你需要在 async 函式內呼叫阻塞程式碼，或在阻塞函式中呼叫 async 函式，你可以使用 [Asyncer](https://asyncer.tiangolo.com)，它是 FastAPI 的姊妹函式庫。

///

### `yield from` { #yield-from }

{* ../../docs_src/security/tutorial001_an_py310.py hl[8] *}

/// tip

Here `tokenUrl="token"` refers to a relative URL `token` that we haven't created yet. As it's a relative URL, it's equivalent to `./token`.

{* ../../docs_src/security/tutorial001_an_py310.py hl[8] *}

/// tip | Astuce

Ici `tokenUrl="token"` fait référence à une URL relative `token` que nous n'avons pas encore créée. Comme c'est une URL relative, elle est équivalente à `./token`.

Некоторый текст
///

/// note | Примечание
Некоторый текст
///

/// note | Технические подробности
Некоторый текст
///

/// check | Проверка
Некоторый текст
///

/// tip | Совет
Некоторый текст
///

/// warning | Предупреждение
Некоторый текст
///

/// danger | Опасность
Некоторый текст
///

////

//// tab | Информация

  pymdownx.tilde: null
  pymdownx.blocks.admonition:
    types:
    - note
    - attention
    - caution
    - danger
    - error
    - tip
    - hint
    - warning
    - info
    - check
  pymdownx.blocks.details: null
  pymdownx.blocks.tab:
    alternate_style: true
  mdx_include: null
  markdown_include_variants: null
extra:

Mais vous auriez le même support de l'éditeur avec [PyCharm](https://www.jetbrains.com/pycharm/) et la majorité des autres éditeurs de code Python :

<img src="/img/tutorial/body/image05.png">

/// tip | Astuce

Si vous utilisez [PyCharm](https://www.jetbrains.com/pycharm/) comme éditeur, vous pouvez utiliser le plug-in [Pydantic PyCharm Plugin](https://github.com/koxudaxi/pydantic-pycharm-plugin/).

# 在容器中使用 FastAPI - Docker { #fastapi-in-containers-docker }

部署 FastAPI 應用時，一個常見做法是建置一個「Linux 容器映像（container image）」。通常使用 [Docker](https://www.docker.com/) 來完成。之後你可以用多種方式部署該容器映像。

使用 Linux 容器有多種優點，包括安全性、可重現性、簡單性等。

/// tip | 提示

趕時間而且已經懂這些？直接跳到下面的 [`Dockerfile` 👇](#build-a-docker-image-for-fastapi)。

///

<details>
<summary>Dockerfile 預覽 👀</summary>

```Dockerfile
FROM python:3.14

WORKDIR /code

C'est ce que nous allons voir ici.

Dans ce cas, vous accepteriez n'importe quel `dict` tant qu'il a des clés `int` avec des valeurs `float` :

{* ../../docs_src/body_nested_models/tutorial009_py310.py hl[7] *}

/// tip | Astuce

Gardez à l'esprit que JSON ne prend en charge que des `str` comme clés.

Mais Pydantic dispose d'une conversion automatique des données.

レスポンスモデルを宣言しない場合、FastAPI は [JSON互換エンコーダ](../tutorial/encoder.md) で説明されている `jsonable_encoder` を使用し、その結果を `JSONResponse` に入れます。

また、`JSONResponse` を直接作成して返すこともできます。

/// tip

通常は、`JSONResponse` を直接返すよりも、[レスポンスモデル](../tutorial/response-model.md) を使うほうがパフォーマンスが大幅に良くなります。これは、Pydantic によるシリアライズが Rust で実行されるためです。

///

## `Response` を返す { #return-a-response }

請先建立並啟用一個 [虛擬環境](../virtual-environments.md)，接著再安裝伺服器程式。

例如，安裝 Uvicorn：

<div class="termy">

```console
$ pip install "uvicorn[standard]"

---> 100%
```

</div>

其他 ASGI 伺服器的安裝流程也大致相同。

/// tip

加入 `standard` 會讓 Uvicorn 安裝並使用一些建議的額外相依套件。

其中包含 `uvloop`，它是 `asyncio` 的高效能替代實作，可大幅提升並行效能。

當你用 `pip install "fastapi[standard]"` 安裝 FastAPI 時，也會一併取得 `uvicorn[standard]`。

///