🌐 Add Chinese translation for Tutorial - Request - Forms - and - Files (#3249)

Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>

diff --git a/docs/zh/docs/tutorial/request-forms-and-files.md b/docs/zh/docs/tutorial/request-forms-and-files.md
new file mode 100644 (file)
index 0000000..a27ba93
--- /dev/null
+++ b/docs/zh/docs/tutorial/request-forms-and-files.md
@@ -0,0 +1,38 @@
+# 请求表单与文件
+
+FastAPI 支持同时使用 `File` 和 `Form` 定义文件和表单字段。
+
+!!! info "说明"
+
+    接收上传文件或表单数据，要预先安装 <a href="https://andrew-d.github.io/python-multipart/" class="external-link" target="_blank">`python-multipart`</a>。
+    
+    例如，`pip install python-multipart`。
+
+## 导入 `File` 与 `Form`
+
+```Python hl_lines="1"
+{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+```
+
+## 定义 `File` 与 `Form` 参数
+
+创建文件和表单参数的方式与 `Body` 和 `Query` 一样：
+
+```Python hl_lines="8"
+{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+```
+
+文件和表单字段作为表单数据上传与接收。
+
+声明文件可以使用 `bytes` 或 `UploadFile` 。
+
+!!! warning "警告"
+
+    可在一个*路径操作*中声明多个 `File` 与 `Form` 参数，但不能同时声明要接收 JSON 的 `Body` 字段。因为此时请求体的编码为 `multipart/form-data`，不是 `application/json`。
+    
+    这不是 **FastAPI** 的问题，而是 HTTP 协议的规定。
+
+## 小结
+
+在同一个请求中接收数据和文件时，应同时使用 `File` 和 `Form`。
+

diff --git a/docs/zh/mkdocs.yml b/docs/zh/mkdocs.yml
index ed1142214b48cef0b974f08d5d956d5c68899fa4..85e470e59bacbeaca5bcaa342dcec1ebaffac95a 100644 (file)
--- a/docs/zh/mkdocs.yml
+++ b/docs/zh/mkdocs.yml
@@ -75,6 +75,7 @@ nav:
   - tutorial/cookie-params.md
   - tutorial/request-forms.md
   - tutorial/request-files.md
+  - tutorial/request-forms-and-files.md
   - tutorial/handling-errors.md
   - tutorial/body-updates.md
   - 安全性: