]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Update Chinese translation for `docs/tutorial/body-fields.md` (#3496)
authorjaystone776 <jilei776@gmail.com>
Mon, 1 Apr 2024 05:35:27 +0000 (13:35 +0800)
committerGitHub <noreply@github.com>
Mon, 1 Apr 2024 05:35:27 +0000 (00:35 -0500)
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
docs/zh/docs/tutorial/body-fields.md

index fb6c6d9b6a45eb59332c6f923900adc998d3c0b3..6c68f100870a7e57bacc9222e7d076e9cd3fa4dd 100644 (file)
@@ -1,10 +1,10 @@
 # 请求体 - 字段
 
-与使用 `Query`、`Path` 和 `Body` 在*路径操作函数*中声明额外的校验和元数据的方式相同,你可以使用 Pydantic 的 `Field` 在 Pydantic 模型内部声明校验和元数据。
+与在*路径操作函数*中使用 `Query`、`Path` 、`Body` 声明校验与元数据的方式一样,可以使用 Pydantic 的 `Field` 在 Pydantic 模型内部声明校验和元数据。
 
 ## 导入 `Field`
 
-é¦\96å\85\88ï¼\8cä½ å¿\85须导å\85¥å®\83
+é¦\96å\85\88ï¼\8cä»\8e Pydantic ä¸­å¯¼å\85¥ `Field`
 
 === "Python 3.10+"
 
     {!> ../../../docs_src/body_fields/tutorial001.py!}
     ```
 
-!!! warning
-    注意,`Field` 是直接从 `pydantic` 导入的,而不是像其他的(`Query`,`Path`,`Body` 等)都从 `fastapi` 导入。
+!!! warning "警告"
+
+    注意,与从 `fastapi` 导入 `Query`,`Path`、`Body` 不同,要直接从 `pydantic` 导入 `Field` 。
 
 ## 声明模型属性
 
\84¶å\90\8eï¼\8cä½ å\8f¯ä»¥å¯¹æ¨¡å\9e\8bå±\9eæ\80§ä½¿ç\94¨ `Field`
\84¶å\90\8eï¼\8c使ç\94¨ `Field` å®\9aä¹\89模å\9e\8bç\9a\84å±\9eæ\80§
 
 === "Python 3.10+"
 
     {!> ../../../docs_src/body_fields/tutorial001.py!}
     ```
 
-`Field` 的工作方式和 `Query`、`Path` 和 `Body` 相同,包括它们的参数等等也完全相同。
+`Field` 的工作方式和 `Query`、`Path`、`Body` 相同,参数也相同。
 
 !!! note "技术细节"
-    实际上,`Query`、`Path` 和其他你将在之后看到的类,创建的是由一个共同的 `Params` 类派生的子类的对象,该共同类本身又是 Pydantic 的 `FieldInfo` 类的子类。
 
-    Pydantic 的 `Field` 也会返回一个 `FieldInfo` 的实例。
+    实际上,`Query`、`Path` 都是 `Params` 的子类,而 `Params` 类又是 Pydantic 中 `FieldInfo` 的子类。
+
+    Pydantic 的 `Field` 返回也是 `FieldInfo` 的类实例。
+
+    `Body` 直接返回的也是 `FieldInfo` 的子类的对象。后文还会介绍一些 `Body` 的子类。
 
-    `Body` 也直接返回 `FieldInfo` 的一个子类的对象。还有其他一些你之后会看到的类是 `Body` 类的子类
+    注意,从 `fastapi` 导入的 `Query`、`Path` 等对象实际上都是返回特殊类的函数
 
-    请记住当你从 `fastapi` 导入 `Query`、`Path` 等对象时,他们实际上是返回特殊类的函数。
+!!! tip "提示"
 
-!!! tip
-    注意每个模型属性如何使用类型、默认值和 `Field` 在代码结构上和*路径操作函数*的参数是相同的,区别是用 `Field` 替换`Path`、`Query` 和 `Body`。
+    注意,模型属性的类型、默认值及 `Field` 的代码结构与*路径操作函数*的参数相同,只不过是用 `Field` 替换了`Path`、`Query`、`Body`。
 
-## 添加额外信息
+## 添加更多信息
 
-你可以在 `Field`、`Query`、`Body` 中声明额外的信息。这些信息将包含在生成的 JSON Schema 中
+`Field`、`Query`、`Body` 等对象里可以声明更多信息,并且 JSON Schema 中也会集成这些信息
 
-你将在文档的后面部分学习声明示例时,了解到更多有关添加额外信息的知识。
+*声明示例*一章中将详细介绍添加更多信息的知识。
 
-## 
+## 
 
-你可以使用 Pydantic 的 `Field` 为模型属性声明额外的校验和元数据。
+Pydantic 的 `Field` 可以为模型属性声明更多校验和元数据。
 
½ è¿\98å\8f¯ä»¥ä½¿ç\94¨é¢\9då¤\96ç\9a\84å\85³é\94®å­\97å\8f\82æ\95°æ\9d¥ä¼ é\80\92é¢\9då¤\96ç\9a\84 JSON Schema å\85\83æ\95°æ\8d®
¼ é\80\92 JSON Schema å\85\83æ\95°æ\8d®è¿\98å\8f¯ä»¥ä½¿ç\94¨æ\9b´å¤\9aå\85³é\94®å­\97å\8f\82æ\95°