Python FastAPI 入门教程：新手快速上手指南

这篇教程的目标是帮助零基础开发者独立写出生产级别的 RESTful API。

1. 为什么选择 FastAPI

维度	FastAPI	Flask	Django	结论
开发速度	★★★★★	★★★★☆	★★★☆☆	最快
性能	接近 Node.js / Go	中等	中等偏下	目前 Python 最快
自动文档	OpenAPI + Swagger + ReDoc	需手动或扩展	admin 强大但 API 需额外写	碾压
类型提示支持	原生 Pydantic v2	需插件	部分支持	现代开发标配
异步支持	原生 async/await	需 gevent 或异步扩展	Channels（较重）	天生异步
学习曲线（新手）	中等（但文档极好）	最低	较高	性价比最高
社区活跃度	爆炸式增长	成熟但增速放缓	非常成熟	未来 3–5 年首选

一句话结论：如果你 2025–2026 年想用 Python 写高性能、现代、好维护的 API，FastAPI 几乎是唯一主流选择。

2. 环境准备

推荐组合（最稳） Python 3.10 / 3.11 / 3.12 + uv / pdm / poetry（现代包管理） + venv

最快上手方式（5 分钟）

# 方式一：用 uv（2025 年最推荐的极简工具，速度比 pip 快 10–100 倍）
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate # Windows 用 .venv\Scripts\activate
uv pip install fastapi[standard]
uvicorn[standard]

备选方式（经典 pip + venv）

python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install --upgrade pip
pip install fastapi[standard] uvicorn[standard]

安装完成后运行下面代码测试：

# main.py
from fastapi import FastAPI
app = FastAPI()

@app.get("/")
def ():
     {: }