2026年6月4日 · 后端框架 · 1分钟阅读

FastAPI 本地开发指南

使用 FastAPI 与 Uvicorn 在 localhost:8000 运行高性能 Python API，自带 OpenAPI 文档。

FastAPI 是现代 Python 异步 API 框架，基于类型提示，自动生成 OpenAPI/Swagger 文档。本地通过 Uvicorn 运行，默认 **http://localhost:8000**。

快速开始

pip install fastapi uvicorn[standard]

main.py：

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello from FastAPI on localhost"}

uvicorn main:app --reload

访问 **http://localhost:8000**。

自动 API 文档

路径	说明
`/docs`	Swagger UI
`/redoc`	ReDoc

例如 http://localhost:8000/docs

修改端口

uvicorn main:app --reload --port 8080

与 Django/Flask 对比

框架	默认端口	侧重
FastAPI	8000	异步 REST API
Django	8000	全栈 + Admin
Flask	5000	同步微框架

与前端联调

Vite（5173）请求 FastAPI（8000）需 CORS：

from fastapi.middleware.cors import CORSMiddleware

app.add_middleware(
    CORSMiddleware,
    allow_origins=["http://localhost:5173"],
    allow_methods=["*"],
    allow_headers=["*"],
)

常见问题

8000 与 Django 冲突
同时跑 Django 与 FastAPI 时，其中一个改端口。

—reload 不生效
确认修改的是入口模块；Windows 有时需 watchfiles。

小结

FastAPI 本地运行 uvicorn main:app --reload，默认 http://localhost:8000**，**/docs 提供交互式 API 文档。