一、知识回顾（读完直接做下面的实践题）#

1. Web 全称万维网（World Wide Web），是能通过浏览器访问到的网站
2. 网站三部分：前端程序负责界面展示、服务端程序负责业务逻辑、数据库负责数据存储管理
3. 前端网页由 HTML（结构）、CSS（样式）、JavaScript（行为）组成
4. Python 中开发服务端可以用 Django、Flask 或 FastAPI
5. FastAPI 是现代、快速、高性能的 Web 框架，基于 Python 的类型提示构建 API
6. API 接口就是对外提供的功能入口，供别人调用
7. FastAPI 四步：导入 → 创建 FastAPI 实例 → 创建路径操作函数 → 运行服务
8. 两个启动命令：fastapi dev "main.py" 或 uvicorn main:app --reload
9. uvicorn 是专门为 FastAPI/Starlette 设计的高性能服务器

二、裸写题#

• 2-1 第一个接口 写一个 FastAPI 程序：/ 返回 {"message": "Hello World"}，/users 返回 3 个用户的列表。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：创建实例 → 用装饰器把函数”挂”到路径上 二级 · 方法：app = FastAPI() / @app.get("/") 三级 · 骨架：函数返回字典或列表，FastAPI 会自动转成 JSON

  参考答案（做完再点开）

  1
  # 2-1
  2
  from fastapi import FastAPI
  3
  
  4
  app = FastAPI(title="入门练习")
  5
  
  6
  USERS = [
  7
      {"id": 1, "name": "张三"},
  8
      {"id": 2, "name": "李四"},
  9
      {"id": 3, "name": "王五"},
  10
  ]
  11
  
  12
  @app.get("/")
  13
  def root():
  14
      return {"message": "Hello World"}
  15
  
  16
  @app.get("/users")
  17
  def get_users():
  18
      return USERS

  显示更多显示更少

• 2-2 带路径参数的接口 再加一个 /users/{user_id} 接口：根据路径里的编号返回对应用户（编号不存在就返回提示）。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：路径里的花括号就是”路径参数”，要写进函数形参 二级 · 方法：@app.get("/users/{user_id}") + def get_user(user_id: int): 三级 · 骨架：user_id: int 会让 FastAPI 自动把字符串转成整数

  参考答案（做完再点开）

  1
  # 2-2
  2
  @app.get("/users/{user_id}")
  3
  def get_user(user_id: int):
  4
      for user in USERS:
  5
          if user["id"] == user_id:
  6
              return user
  7
      return {"message": "用户不存在"}

• 2-3 用测试客户端验证 不启动服务器，用 FastAPI 自带的测试客户端直接请求上面几个接口，打印状态码和返回内容。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：像写单元测试一样调接口，不用真的开服务器 二级 · 方法：from fastapi.testclient import TestClient / client = TestClient(app) 三级 · 骨架：print(response.status_code, response.json())

  参考答案（做完再点开）

  1
  # 2-3：不启动服务器也能测
  2
  from fastapi.testclient import TestClient
  3
  
  4
  if __name__ == "__main__":
  5
      client = TestClient(app)
  6
      for path in ["/", "/users", "/users/2", "/users/99"]:
  7
          resp = client.get(path)
  8
          print(path, resp.status_code, resp.json())
  9
  
  10
  # 真正启动服务时用：
  11
  #   fastapi dev main.py   或   uvicorn main:app --reload