uv add fastapi "uvicorn[standard]"
# 验证
uv run python -c "import fastapi; print(fastapi.__version__)"
# main.py
from fastapi import FastAPI
app = FastAPI(title="我的第一个 API")
@app.get("/")
def read_root():
return {"message": "Hello, FastAPI!"}
@app.get("/hello/{name}")
def say_hello(name: str):
return {"message": f"你好,{name}!"}
# 启动
uvicorn main:app --reload
# 访问 http://127.0.0.1:8000
# 自动文档 http://127.0.0.1:8000/docs
# 路径参数(必选)
@app.get("/users/{user_id}")
def get_user(user_id: int):
return {"user_id": user_id}
# /users/1 → {"user_id": 1}
# 查询参数(可选)
@app.get("/search")
def search(q: str, limit: int = 10):
return {"query": q, "limit": limit}
# /search?q=python&limit=20
# 混合
@app.get("/users/{user_id}/posts")
def get_user_posts(user_id: int, published: bool = True):
return {"user_id": user_id, "published": published}
# /users/1/posts?published=false
FastAPI 最大的卖点:自动生成 OpenAPI 文档。
/docs:Swagger UI(可以直接测试 API)/redoc:ReDoc(更好看的文档)/openapi.json:原始 OpenAPI JSON@app.get("/me")
def me():
return {"name": "张三", "role": "前端工程师→Python"}
# 启动后访问 http://127.0.0.1:8000/me
@app.get("/add/{a}/{b}")
def add(a: int, b: int):
return {"result": a + b, "expression": f"{a}+{b}={a+b}"}
# /add/3/5 → {"result": 8}
@app.get("/items")
def list_items(page: int = 1, size: int = 10):
return {"page": page, "size": size, "items": [...]}
# /items?page=2&size=20