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

1. 汉字谜盒项目里 static/ 存放前端静态资源（HTML/CSS/JS），sessions/ 存放会话数据（json 文件）
2. 让根路径返回前端页面用 FileResponse 响应类：return FileResponse("static/index.html")
3. 挂载静态目录：app.mount("/static", StaticFiles(directory="static"), name="static")
4. "/static" 是挂载路径，任何以它开头的请求都交给静态资源处理
5. 页面里引用资源写成 /static/style.css（以 / 开头），是为了避免和**接口（API）**路径冲突
6. 前端通过 fetch 调用接口，本项目所有接口路径都以 /api 开头

二、裸写题#

• 2-1 搭一个能返回页面的服务 新建项目文件夹，写 main.py：挂载 static 目录，并让 / 返回 static/index.html。

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

  一级 · 思路：一个入口返回页面，一个挂载点放静态资源 二级 · 方法：FileResponse / app.mount(...) 三级 · 骨架：app.mount("/____", StaticFiles(directory="____"), name="static")

  参考答案（做完再点开）

  1
  from fastapi import FastAPI
  2
  from fastapi.responses import FileResponse
  3
  from fastapi.staticfiles import StaticFiles
  4
  
  5
  app = FastAPI(title="汉字谜盒")
  6
  
  7
  # 2-1 挂载静态目录 + 首页返回页面
  8
  app.mount("/static", StaticFiles(directory="static"), name="static")
  9
  
  10
  @app.get("/")
  11
  def root():
  12
      return FileResponse("static/index.html")

• 2-2 验证页面能打开 写完后启动服务（fastapi dev main.py），在浏览器打开 http://127.0.0.1:8000/ 确认页面正常显示；再打开 /docs 看看自动生成的接口文档。

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

  一级 · 思路：页面打不开通常是路径问题——先确认 static 是否在项目根目录 二级 · 方法：FileResponse("static/index.html") 里的路径是相对当前工作目录的 三级 · 骨架：用 TestClient 也能验证：client.get("/").status_code 应为 200

  参考答案（做完再点开）

  1
  # 在项目根目录下启动服务
  2
  fastapi dev main.py
  3
  
  4
  # 浏览器打开 http://127.0.0.1:8000/     → 正常显示 static/index.html 页面
  5
  # 浏览器打开 http://127.0.0.1:8000/docs → FastAPI 自动生成的接口文档

• 2-3 用测试客户端检查静态资源 不启动服务器，用 FastAPI 自带的测试客户端分别请求 / 和 /static/style.css，打印状态码。

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

  一级 · 思路：挂载点和页面入口都要能通 二级 · 方法：client.get("/static/style.css") 三级 · 骨架：两个都应返回 200

  参考答案（做完再点开）

  1
  # 2-3 验证（需在项目根目录下运行，且 static/ 里已有文件）
  2
  from fastapi.testclient import TestClient
  3
  
  4
  if __name__ == "__main__":
  5
      client = TestClient(app)
  6
      print("首页:", client.get("/").status_code)                 # 200
  7
      print("样式:", client.get("/static/style.css").status_code)  # 200