FastAPI 从零开始：编写你的第一个 API 路由
发布: (2026年1月12日 GMT+8 08:59)
4 min read
原文: Dev.to
Source: Dev.to
FastAPI 是最快的 Python 框架之一。如果你是 FastAPI 新手，这里你将了解更多，并在不到 10 分钟内编写你的第一个 FastAPI 路由。
目录
什么是 FastAPI？
FastAPI 是一个现代的 Python Web 框架，用于构建高性能的 API（应用程序编程接口）。
FastAPI 的构建块
FastAPI 结合了两个强大的项目：
-
Starlette – 一个轻量级的 ASGI 框架，适合在 Python 中运行异步 Web 服务。
文档 -
Pydantic – 一个用于自动数据验证和序列化的库。它根据 Python 类型和对象验证并序列化数据。
文档
FastAPI 的特性
快速
- 自动数据验证
- 自动序列化（Python 对象 ↔ JSON）
- 原生异步支持（非阻塞操作）
- 自动文档
更少错误
减少约 40 % 的人为开发错误。
直观
出色的编辑器支持、自动补全，调试时间更少。
稳健
具备自动文档的生产就绪代码。
标准化
遵循诸如 OpenAPI 和 JSON Schema 等开放标准。
Source: …
你的第一个 FastAPI 路由
在 Linux 上设置环境
# 更新系统
sudo apt update && sudo apt upgrade
# 全局安装 Python 及相关工具
sudo apt install python3 python3-pip python3-venv
# 创建专用文件夹
mkdir intro_fastapi
cd intro_fastapi
# 创建并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate
# 安装带标准扩展的 FastAPI 和 Uvicorn
pip install "fastapi[standard]" "uvicorn[standard]"在 Windows 上设置环境
# 检查 Python 安装情况
python --version
# 如果未安装 Python，请从以下地址下载：
# https://www.python.org/downloads/windows/
# （安装时请确保勾选 “Add Python to PATH”）
# 创建专用文件夹
mkdir intro_fastapi
cd intro_fastapi
# 创建并激活虚拟环境
python -m venv .venv
.venv\Scripts\activate
# 升级 pip（推荐）
python -m pip install --upgrade pip
# 安装带标准扩展的 FastAPI 和 Uvicorn
pip install "fastapi[standard]" "uvicorn[standard]"编写你的第一个 API 路由
- 确保你位于项目文件夹根目录。
- 用你喜欢的编辑器打开该文件夹。
文件结构
intro_fastapi/
└── app/
└── main.pyapp/main.py
from fastapi import FastAPI
# 创建 FastAPI 类的实例
app = FastAPI()
# 使用装饰器注册第一个路由
@app.get("/")
def welcome():
return {"message": "My First API route"}运行应用
uvicorn app.main:app --reload注意： 在运行上述命令前，请务必确保已激活虚拟环境。
访问以下 URL：
自动文档
FastAPI 提供两种自动文档类型：
-
Swagger UI（交互式测试）：
-
ReDoc（备用 UI）：
