]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Update Chinese translation for `docs/zh/docs/tutorial/index.md` (#13374)
authorZhongheng Cheng <zc2737@columbia.edu>
Mon, 31 Mar 2025 08:15:11 +0000 (04:15 -0400)
committerGitHub <noreply@github.com>
Mon, 31 Mar 2025 08:15:11 +0000 (10:15 +0200)
docs/zh/docs/tutorial/index.md

index ab19f02c5d025ab0f23bad3fb132d346105d6351..3ca927337f98504ca0aff4d65049b4dd7dc601cd 100644 (file)
@@ -1,34 +1,58 @@
 # 教程 - 用户指南
 
-本教程将一步步向展示如何使用 **FastAPI** 的绝大部分特性。
+本教程将一步步向展示如何使用 **FastAPI** 的绝大部分特性。
 
-各个章节的内容循序渐进,但是又围绕着单独的主题,所以你可以直接跳转到某个章节以解决你的特定需求。
+各个章节的内容循序渐进,但是又围绕着单独的主题,所以您可以直接跳转到某个章节以解决您的特定需求。
 
-本教程同样可以作为将来的参考手册。
-
-你可以随时回到本教程并查阅你需要的内容。
+本教程同样可以作为将来的参考手册,所以您可以随时回到本教程并查阅您需要的内容。
 
 ## 运行代码
 
 所有代码片段都可以复制后直接使用(它们实际上是经过测试的 Python 文件)。
 
-要运行任何示例,请将代码复制到 `main.py` 文件中,然后使用以下命令启动 `uvicorn`:
+要运行任何示例,请将代码复制到 `main.py` 文件中,然后使用以下命令启动 `fastapi dev`:
 
 <div class="termy">
 
 ```console
-$ uvicorn main:app --reload
+$ <font color="#4E9A06">fastapi</font> dev <u style="text-decoration-style:solid">main.py</u>
+
+  <span style="background-color:#009485"><font color="#D3D7CF"> FastAPI </font></span>  Starting development server 🚀
+
+             Searching for package file structure from directories
+             with <font color="#3465A4">__init__.py</font> files
+             Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>
+
+   <span style="background-color:#007166"><font color="#D3D7CF"> module </font></span>  🐍 main.py
+
+     <span style="background-color:#007166"><font color="#D3D7CF"> code </font></span>  Importing the FastAPI app object from the module with
+             the following code:
+
+             <u style="text-decoration-style:solid">from </u><u style="text-decoration-style:solid"><b>main</b></u><u style="text-decoration-style:solid"> import </u><u style="text-decoration-style:solid"><b>app</b></u>
+
+      <span style="background-color:#007166"><font color="#D3D7CF"> app </font></span>  Using import string: <font color="#3465A4">main:app</font>
+
+   <span style="background-color:#007166"><font color="#D3D7CF"> server </font></span>  Server started at <font color="#729FCF"><u style="text-decoration-style:solid">http://127.0.0.1:8000</u></font>
+   <span style="background-color:#007166"><font color="#D3D7CF"> server </font></span>  Documentation at <font color="#729FCF"><u style="text-decoration-style:solid">http://127.0.0.1:8000/docs</u></font>
+
+      <span style="background-color:#007166"><font color="#D3D7CF"> tip </font></span>  Running in development mode, for production use:
+             <b>fastapi run</b>
+
+             Logs:
 
-<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-<span style="color: green;">INFO</span>:     Started reloader process [28720]
-<span style="color: green;">INFO</span>:     Started server process [28722]
-<span style="color: green;">INFO</span>:     Waiting for application startup.
-<span style="color: green;">INFO</span>:     Application startup complete.
+     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Will watch for changes in these directories:
+             <b>[</b><font color="#4E9A06">&apos;/home/user/code/awesomeapp&apos;</font><b>]</b>
+     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Uvicorn running on <font color="#729FCF"><u style="text-decoration-style:solid">http://127.0.0.1:8000</u></font> <b>(</b>Press CTRL+C
+             to quit<b>)</b>
+     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Started reloader process <b>[</b><font color="#34E2E2"><b>383138</b></font><b>]</b> using WatchFiles
+     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Started server process <b>[</b><font color="#34E2E2"><b>383153</b></font><b>]</b>
+     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Waiting for application startup.
+     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Application startup complete.
 ```
 
 </div>
 
-强烈建议你在本地编写或复制代码,对其进行编辑并运行。
+**强烈建议**您在本地编写或复制代码,对其进行编辑并运行。
 
 在编辑器中使用 FastAPI 会真正地展现出它的优势:只需要编写很少的代码,所有的类型检查,代码补全等等。
 
@@ -36,48 +60,34 @@ $ uvicorn main:app --reload
 
 ## 安装 FastAPI
 
-第一个步骤是安装 FastAPI
+第一个步骤是安装 FastAPI.
 
-为了使用本教程,你可能需要安装所有的可选依赖及对应功能
+请确保您创建并激活一个[虚拟环境](../virtual-environments.md){.internal-link target=_blank},然后**安装 FastAPI**
 
 <div class="termy">
 
 ```console
-$ pip install "fastapi[all]"
+$ pip install "fastapi[standard]"
 
 ---> 100%
 ```
 
 </div>
 
-......以上安装还包括了 `uvicorn`,你可以将其用作运行代码的服务器。
-
 /// note
 
-你也可以分开来安装。
-
-假如你想将应用程序部署到生产环境,你可能要执行以下操作:
-
-```
-pip install fastapi
-```
-
-并且安装`uvicorn`来作为服务器:
-
-```
-pip install "uvicorn[standard]"
-```
+当您使用 `pip install "fastapi[standard]"` 进行安装时,它会附带一些默认的可选标准依赖项。
 
-然后对你想使用的每个可选依赖项也执行相同的操作
+如果您不想安装这些可选依赖,可以选择安装 `pip install fastapi`
 
 ///
 
 ## 进阶用户指南
 
-在本**教程-用户指南**之后,可以阅读**进阶用户指南**。
+在本**教程-用户指南**之后,可以阅读**进阶用户指南**。
 
 **进阶用户指南**以本教程为基础,使用相同的概念,并教授一些额外的特性。
 
-但是你应该先阅读**教程-用户指南**(即你现在正在阅读的内容)。
+但是您应该先阅读**教程-用户指南**(即您现在正在阅读的内容)。
 
-教程经过精心设计,使你可以仅通过**教程-用户指南**来开发一个完整的应用程序,然后根据你的需要,使用**进阶用户指南**中的一些其他概念,以不同的方式来扩展它。
+教程经过精心设计,使您可以仅通过**教程-用户指南**来开发一个完整的应用程序,然后根据您的需要,使用**进阶用户指南**中的一些其他概念,以不同的方式来扩展它。