🌐 Update translations for zh-hant (update-outdated)

docs/en/docs/release-notes.md

@@ -7,13 +7,6 @@ hide:
 
 ## Latest Changes
 
-## 0.137.1 (2026-06-15)
-
-### Fixes
-
-* 🚨 Fix typing checks for APIRoute. PR [#15765](https://github.com/fastapi/fastapi/pull/15765) by [@tiangolo](https://github.com/tiangolo).
-* 🐛 Fix bug, allow empty path in path operation in prefixless router. PR [#15763](https://github.com/fastapi/fastapi/pull/15763) by [@tiangolo](https://github.com/tiangolo).
-
 ## 0.137.0 (2026-06-14)
 
 ### Breaking Changes

docs/zh-hant/docs/index.md

@@ -479,7 +479,7 @@ item: Item
 
 * 來自不同來源的**參數**宣告：例如 **headers**、**cookies**、**form fields** 和 **files**。
 * 如何設定**驗證限制**，如 `maximum_length` 或 `regex`。
-* 一個非常強大且易用的 **<dfn title="也稱為：components、resources、providers、services、injectables">依賴注入</dfn>** 系統。
+* 一個非常強大且易用的 **<dfn title="也稱為：元件、資源、提供者、服務、可注入物">依賴注入</dfn>** 系統。
 * 安全與驗證，包含支援 **OAuth2** 搭配 **JWT tokens** 與 **HTTP Basic** 驗證。
 * 宣告**深度巢狀 JSON 模型**的進階（但同樣簡單）技巧（感謝 Pydantic）。
 * 與 [Strawberry](https://strawberry.rocks) 及其他函式庫的 **GraphQL** 整合。
@@ -492,9 +492,7 @@ item: Item
 
 ### 部署你的應用（可選） { #deploy-your-app-optional }
 
-你也可以選擇將 FastAPI 應用部署到 [FastAPI Cloud](https://fastapicloud.com)，如果你還沒加入，去登記等候名單吧。🚀
-
-如果你已經有 **FastAPI Cloud** 帳號（我們已從等候名單邀請你 😉），你可以用一個指令部署你的應用。
+你可以選擇只用一個指令，將 FastAPI 應用部署到 [FastAPI Cloud](https://fastapicloud.com)。🚀
 
 <div class="termy">
 
@@ -510,6 +508,8 @@ Deploying to FastAPI Cloud...
 
 </div>
 
+CLI 會自動偵測你的 FastAPI 應用並將其部署到雲端。若你尚未登入，系統會開啟瀏覽器以完成驗證流程。
+
 就這樣！現在你可以在該 URL 造訪你的應用。✨
 
 #### 關於 FastAPI Cloud { #about-fastapi-cloud }

docs/zh-hant/docs/tutorial/body-multiple-params.md

@@ -108,7 +108,7 @@ q: str | None = None
 
 {* ../../docs_src/body_multiple_params/tutorial004_an_py310.py hl[28] *}
 
-/// info | 注意
+/// note | 注意
 
 `Body` 也具有與 `Query`、`Path` 以及之後你會看到的其他工具相同的額外驗證與中繼資料參數。
 
@@ -123,7 +123,7 @@ q: str | None = None
 但如果你想讓它像宣告多個 Body 參數時那樣，期望一個帶有 `item` 鍵、其內含模型內容的 JSON，你可以使用 `Body` 的特殊參數 `embed`：
 
 ```Python
-item: Item = Body(embed=True)
+item: Annotated[Item, Body(embed=True)]
 ```
 
 如下：

docs/zh-hant/docs/tutorial/cookie-params.md

@@ -24,19 +24,19 @@
 
 ///
 
-/// info
+/// note
 
 要宣告 cookies，你需要使用 `Cookie`，否則參數會被當作查詢參數（query parameters）來解析。
 
 ///
 
-/// info
+/// note
 
-請注意，由於瀏覽器以特殊且在背後處理的方式管理 cookies，它們通常不允許 JavaScript 輕易存取它們。
+請注意，由於**瀏覽器會以特殊方式並在背後處理 cookies**，因此**不**容易讓 **JavaScript** 觸碰到它們。
 
-如果你前往位於 `/docs` 的 API 文件介面，你可以在你的路徑操作（path operations）的文件中看到 cookies 的說明。
+如果你前往位於 `/docs` 的 **API 文件介面**，你可以在你的*路徑操作（path operations）*中看到 cookies 的**文件**。
 
-但即使你填入資料並點擊「Execute」，由於該文件介面是以 JavaScript 運作，cookies 不會被送出，你會看到一則錯誤訊息，就好像你沒有填任何值一樣。
+但即使你**填入資料**並點擊「Execute」，由於該文件介面是以 **JavaScript** 運作，cookies 不會被送出，你會看到一則**錯誤**訊息，就好像你沒有填任何值一樣。
 
 ///
 

docs/zh-hant/docs/tutorial/debugging.md

@@ -72,7 +72,7 @@ from myapp import app
 
 就不會被執行。
 
-/// info | 說明
+/// note
 
 想了解更多，參考 [Python 官方文件](https://docs.python.org/3/library/__main__.html)。
 

docs/zh-hant/docs/tutorial/path-operation-configuration.md

@@ -72,13 +72,13 @@
 
 {* ../../docs_src/path_operation_configuration/tutorial005_py310.py hl[18] *}
 
-/// info | 資訊
+/// note | 注意
 
 請注意，`response_description` 專指回應，而 `description` 則是針對整個「路徑操作」的一般描述。
 
 ///
 
-/// check | 檢查
+/// tip
 
 OpenAPI 規範要求每個「路徑操作」都必須有一個回應描述。
 

docs/zh-hant/docs/tutorial/path-params-numeric-validations.md

@@ -8,7 +8,7 @@
 
 {* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
 
-/// info
+/// note
 
 FastAPI 在 0.95.0 版加入並開始推薦使用 `Annotated`。
 
@@ -131,7 +131,7 @@ Python 不會對這個 `*` 做任何事，但它會知道後續的所有參數
 * `lt`：小於（`l`ess `t`han）
 * `le`：小於或等於（`l`ess than or `e`qual）
 
-/// info
+/// note
 
 你之後會看到的 `Query`、`Path` 與其他類別，都是共同父類別 `Param` 的子類別。
 

docs/zh-hant/docs/tutorial/request-files.md

@@ -2,7 +2,7 @@
 
 你可以使用 `File` 定義由用戶端上傳的檔案。
 
-/// info
+/// note
 
 若要接收上傳的檔案，請先安裝 [`python-multipart`](https://github.com/Kludex/python-multipart)。
 
@@ -28,7 +28,7 @@ $ pip install python-multipart
 
 {* ../../docs_src/request_files/tutorial001_an_py310.py hl[9] *}
 
-/// info
+/// note
 
 `File` 是直接繼承自 `Form` 的類別。
 

docs/zh-hant/docs/tutorial/request-forms-and-files.md

@@ -2,7 +2,7 @@
 
 你可以使用 `File` 與 `Form` 同時定義檔案與表單欄位。
 
-/// info
+/// note
 
 要接收上傳的檔案與/或表單資料，請先安裝 [`python-multipart`](https://github.com/Kludex/python-multipart)。
 

docs/zh-hant/docs/tutorial/response-status-code.md

@@ -18,7 +18,7 @@
 
 參數 `status_code` 接受一個數字作為 HTTP 狀態碼。
 
-/// info | 資訊
+/// note | 注意
 
 `status_code` 也可以接收一個 `IntEnum`，例如 Python 的 [`http.HTTPStatus`](https://docs.python.org/3/library/http.html#http.HTTPStatus)。
 
@@ -27,7 +27,7 @@
 它會：
 
 * 在回應中傳回該狀態碼。
-* 在 OpenAPI 結構中如此記錄（因此也會反映在使用者介面中）：
+* 在 OpenAPI 構架中如此記錄（因此也會反映在使用者介面中）：
 
 <img src="/img/tutorial/response-status-code/image01.png">
 

docs/zh-hant/docs/tutorial/testing.md

@@ -8,7 +8,7 @@
 
 ## 使用 `TestClient` { #using-testclient }
 
-/// info
+/// note
 
 要使用 `TestClient`，請先安裝 [`httpx`](https://www.python-httpx.org)。
 
@@ -144,7 +144,7 @@ $ pip install httpx
 
 關於如何把資料傳給後端（使用 `httpx` 或 `TestClient`），更多資訊請參考 [HTTPX 文件](https://www.python-httpx.org)。
 
-/// info
+/// note
 
 請注意，`TestClient` 接收的是可轉為 JSON 的資料，而不是 Pydantic models。
 

fastapi/__init__.py

@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.137.1"
+__version__ = "0.137.0"
 
 from starlette import status as status
 

fastapi/routing.py

@@ -930,6 +930,28 @@ def _populate_api_route_state(
     route.path = path
     route.endpoint = endpoint
     route.stream_item_type = None
+    if isinstance(response_model, DefaultPlaceholder):
+        return_annotation = get_typed_return_annotation(endpoint)
+        if lenient_issubclass(return_annotation, Response):
+            response_model = None
+        else:
+            stream_item = get_stream_item_type(return_annotation)
+            if stream_item is not None:
+                # Extract item type for JSONL or SSE streaming when
+                # response_class is DefaultPlaceholder (JSONL) or
+                # EventSourceResponse (SSE).
+                # ServerSentEvent is excluded: it's a transport
+                # wrapper, not a data model, so it shouldn't feed
+                # into validation or OpenAPI schema generation.
+                if (
+                    isinstance(response_class, DefaultPlaceholder)
+                    or lenient_issubclass(response_class, EventSourceResponse)
+                ) and not lenient_issubclass(stream_item, ServerSentEvent):
+                    route.stream_item_type = stream_item
+                response_model = None
+            else:
+                response_model = return_annotation
+    route.response_model = response_model
     route.summary = summary
     route.response_description = response_description
     route.deprecated = deprecated
@@ -965,6 +987,27 @@ def _populate_api_route_state(
     if isinstance(status_code, IntEnum):
         status_code = int(status_code)
     route.status_code = status_code
+    if route.response_model:
+        assert is_body_allowed_for_status_code(status_code), (
+            f"Status code {status_code} must not have a response body"
+        )
+        response_name = "Response_" + route.unique_id
+        route.response_field = create_model_field(
+            name=response_name,
+            type_=route.response_model,
+            mode="serialization",
+        )
+    else:
+        route.response_field = None
+    if route.stream_item_type:
+        stream_item_name = "StreamItem_" + route.unique_id
+        route.stream_item_field = create_model_field(
+            name=stream_item_name,
+            type_=route.stream_item_type,
+            mode="serialization",
+        )
+    else:
+        route.stream_item_field = None
     route.dependencies = list(dependencies or [])
     route.description = description or inspect.cleandoc(route.endpoint.__doc__ or "")
     # if a "form feed" character (page break) is found in the description text,
@@ -1016,88 +1059,9 @@ def _populate_api_route_state(
     route.is_json_stream = is_generator and isinstance(
         response_class, DefaultPlaceholder
     )
-    if isinstance(response_model, DefaultPlaceholder):
-        return_annotation = get_typed_return_annotation(endpoint)
-        if lenient_issubclass(return_annotation, Response):
-            response_model = None
-        else:
-            stream_item = get_stream_item_type(return_annotation)
-            if stream_item is not None and is_generator:
-                # Extract item type for JSONL or SSE streaming for
-                # generator endpoints when response_class is
-                # DefaultPlaceholder (JSONL) or EventSourceResponse
-                # (SSE).
-                # ServerSentEvent is excluded: it's a transport
-                # wrapper, not a data model, so it shouldn't feed
-                # into validation or OpenAPI schema generation.
-                if (
-                    isinstance(response_class, DefaultPlaceholder)
-                    or lenient_issubclass(response_class, EventSourceResponse)
-                ) and not lenient_issubclass(stream_item, ServerSentEvent):
-                    route.stream_item_type = stream_item
-                response_model = None
-            else:
-                response_model = return_annotation
-    route.response_model = response_model
-    if route.response_model:
-        assert is_body_allowed_for_status_code(status_code), (
-            f"Status code {status_code} must not have a response body"
-        )
-        response_name = "Response_" + route.unique_id
-        route.response_field = create_model_field(
-            name=response_name,
-            type_=route.response_model,
-            mode="serialization",
-        )
-    else:
-        route.response_field = None
-    if route.stream_item_type:
-        stream_item_name = "StreamItem_" + route.unique_id
-        route.stream_item_field = create_model_field(
-            name=stream_item_name,
-            type_=route.stream_item_type,
-            mode="serialization",
-        )
-    else:
-        route.stream_item_field = None
 
 
 class APIRoute(routing.Route):
-    stream_item_type: Any | None
-    response_model: Any
-    summary: str | None
-    response_description: str
-    deprecated: bool | None
-    operation_id: str | None
-    response_model_include: IncEx | None
-    response_model_exclude: IncEx | None
-    response_model_by_alias: bool
-    response_model_exclude_unset: bool
-    response_model_exclude_defaults: bool
-    response_model_exclude_none: bool
-    include_in_schema: bool
-    response_class: type[Response] | DefaultPlaceholder
-    dependency_overrides_provider: Any | None
-    callbacks: list[BaseRoute] | None
-    openapi_extra: dict[str, Any] | None
-    generate_unique_id_function: Callable[[Any], str] | DefaultPlaceholder
-    strict_content_type: bool | DefaultPlaceholder
-    tags: list[str | Enum]
-    responses: dict[int | str, dict[str, Any]]
-    unique_id: str
-    status_code: int | None
-    response_field: ModelField | None
-    stream_item_field: ModelField | None
-    dependencies: list[params.Depends]
-    description: str
-    response_fields: dict[int | str, ModelField]
-    dependant: Dependant
-    _flat_dependant: Dependant
-    _embed_body_fields: bool
-    body_field: ModelField | None
-    is_sse_stream: bool
-    is_json_stream: bool
-
     def __init__(
         self,
         path: str,
@@ -2471,16 +2435,9 @@ class APIRouter(routing.Router):
                 "A path prefix must not end with '/', as the routes will start with '/'"
             )
         else:
-            for route, route_context in _iter_routes_with_context(router.routes):
-                if route_context is None:
-                    path = getattr(route, "path", None)
-                    name = getattr(route, "name", "unknown")
-                elif route_context.starlette_route is not None:
-                    path = getattr(route_context.starlette_route, "path", None)
-                    name = getattr(route_context.starlette_route, "name", "unknown")
-                else:
-                    path = route_context.path
-                    name = route_context.name
+            for r in _iter_included_route_candidates(router.routes):
+                path = getattr(r, "path", None)
+                name = getattr(r, "name", "unknown")
                 if path is not None and not path:
                     raise FastAPIError(
                         f"Prefix and path cannot be both empty (path operation: {name})"

tests/test_router_include_context.py

@@ -2,7 +2,6 @@ from typing import Annotated, cast
 
 import pytest
 from fastapi import APIRouter, Body, Depends, FastAPI, Request
-from fastapi.exceptions import FastAPIError
 from fastapi.responses import HTMLResponse, JSONResponse, PlainTextResponse
 from fastapi.routing import (
     APIRoute,
@@ -808,60 +807,6 @@ def test_no_prefix_include_validation_sees_effective_starlette_route_candidates(
     assert cast(Route, candidates[0]).path == "/child/items"
 
 
-def test_no_prefix_include_validation_sees_effective_api_route_path():
-    leaf_router = APIRouter()
-
-    @leaf_router.get("")
-    def read_items():
-        return []
-
-    parent_router = APIRouter()
-    parent_router.include_router(leaf_router, prefix="/items")
-
-    # for coverage
-    candidates = list(_iter_included_route_candidates(parent_router.routes))
-    assert cast(APIRoute, candidates[0]).path == ""
-
-    app = FastAPI()
-    app.include_router(parent_router)
-    client = TestClient(app)
-
-    response = client.get("/items")
-
-    assert response.status_code == 200, response.text
-    assert response.json() == []
-
-
-def test_no_prefix_include_validation_sees_effective_starlette_route_path():
-    def endpoint(request):
-        return PlainTextResponse("ok")
-
-    child_router = APIRouter(routes=[Route("/items", endpoint, name="read_items")])
-    parent_router = APIRouter()
-    parent_router.include_router(child_router, prefix="/child")
-
-    app = FastAPI()
-    app.include_router(parent_router)
-    client = TestClient(app)
-
-    response = client.get("/child/items")
-
-    assert response.status_code == 200, response.text
-    assert response.text == "ok"
-
-
-def test_no_prefix_include_validation_rejects_empty_effective_api_route_path():
-    router = APIRouter()
-
-    @router.get("")
-    def read_items():  # pragma: no cover
-        return []
-
-    app = FastAPI()
-    with pytest.raises(FastAPIError):
-        app.include_router(router)
-
-
 def test_apirouter_matches_fallback_without_include_context():
     router = APIRouter()
 

tests/test_skip_defaults.py

@@ -1,5 +1,3 @@
-from collections.abc import Iterable
-
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 from pydantic import BaseModel
@@ -67,21 +65,6 @@ def get_exclude_unset_none() -> ModelDefaults:
     return ModelDefaults(x=None, y="y")
 
 
-@app.get("/iterable_exclude_unset", response_model_exclude_unset=True)
-def get_iterable_exclude_unset() -> Iterable[ModelDefaults]:
-    return [ModelDefaults(x=None, y="y")]
-
-
-@app.get("/iterable_exclude_defaults", response_model_exclude_defaults=True)
-def get_iterable_exclude_defaults() -> Iterable[ModelDefaults]:
-    return [ModelDefaults(x=None, y="y")]
-
-
-@app.get("/iterable_exclude_none", response_model_exclude_none=True)
-def get_iterable_exclude_none() -> Iterable[ModelDefaults]:
-    return [ModelDefaults(x=None, y="y")]
-
-
 client = TestClient(app)
 
 
@@ -108,18 +91,3 @@ def test_return_exclude_none():
 def test_return_exclude_unset_none():
     response = client.get("/exclude_unset_none")
     assert response.json() == {"y": "y"}
-
-
-def test_return_iterable_exclude_unset():
-    response = client.get("/iterable_exclude_unset")
-    assert response.json() == [{"x": None, "y": "y"}]
-
-
-def test_return_iterable_exclude_defaults():
-    response = client.get("/iterable_exclude_defaults")
-    assert response.json() == [{}]
-
-
-def test_return_iterable_exclude_none():
-    response = client.get("/iterable_exclude_none")
-    assert response.json() == [{"y": "y", "z": "z"}]