· 约 2 分钟

03-FastAPI基础入门-第一个FastAPI程序

  • FastAPI
  • Python

学习目标

  • 创建第一个 FastAPI 项目
  • 学会启动开发服务器
  • 认识自动生成的接口文档页面

核心概念

第一个 FastAPI 程序的目标不是“把功能写复杂”，而是先跑通最小闭环：

  1. 安装依赖
  2. 写出 app = FastAPI()
  3. 定义一个路由
  4. 用 uvicorn 启动
  5. 打开 /docs

常用安装命令：

pip install fastapi uvicorn

启动命令：

uvicorn main:app --reload

其中：

  • main 是文件名
  • app 是 FastAPI 实例名
  • --reload 表示开发模式自动重载

代码示例

from fastapi import FastAPI

app = FastAPI()


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


@app.get("/ping")
def ping():
    return {"status": "ok"}

运行结果

启动后通常访问：

  • http://127.0.0.1:8000/
  • http://127.0.0.1:8000/ping
  • http://127.0.0.1:8000/docs

其中 /docs 是学习 FastAPI 时非常重要的页面，因为它不仅能看接口说明，还能直接在线测试。

易错点

  • uvicorn main:app --reload 中的 main 和 app 写错
  • 文件名不是 main.py，却还用 main:app
  • 启动成功了，却打不开 /docs，通常是端口不对或服务没真正起来

我的补充

第一次学 FastAPI，一定要把 /docs 养成习惯。后面很多参数校验和请求体结构，看文档页比只看代码更直观。