跳转至

静态文件

您可以使用 StaticFiles从目录中自动提供静态文件。

使用StaticFiles

  • 导入StaticFiles。
  • "挂载"(Mount) 一个 StaticFiles() 实例到一个指定路径。
from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

app.mount("/static", StaticFiles(directory="static"), name="static")

技术细节

你也可以用 from starlette.staticfiles import StaticFiles。

FastAPI 提供了和 starlette.staticfiles 相同的 fastapi.staticfiles ，只是为了方便你，开发者。但它确实来自Starlette。

什么是"挂载"(Mounting)

"挂载" 表示在特定路径添加一个完全"独立的"应用，然后负责处理所有子路径。

这与使用APIRouter不同，因为安装的应用程序是完全独立的。OpenAPI和来自你主应用的文档不会包含已挂载应用的任何东西等等。

你可以在高级用户指南中了解更多。

细节

这个 "子应用" 会被 "挂载" 到第一个 "/static" 指向的子路径。因此，任何以"/static"开头的路径都会被它处理。

directory="static" 指向包含你的静态文件的目录名字。

name="static" 提供了一个能被FastAPI内部使用的名字。

所有这些参数可以不同于"static"，根据你应用的需要和具体细节调整它们。

更多信息

更多细节和选择查阅 Starlette's docs about Static Files.