FastAPI 更换 docs文档风格

一种常见的需求是更换FastAPI生成的文档中的默认样式和布局。FastAPI的文档生成是基于Swagger UI实现的，它使用了一套默认的样式和布局。要更换这些默认的样式和布局，我们需要对FastAPI的文档生成进行定制。

首先，我们需要安装必要的依赖。在项目的根目录下，打开命令行并运行以下命令：

pip install fastapi

接下来，我们需要创建一个templates目录，用于存放我们自定义的模板文件。在templates目录下创建一个index.html文件，这个文件将作为我们生成的文档的主页。在index.html中，我们可以编写自定义的HTML和CSS代码，来更换默认的样式和布局。例如，我们可以修改标题的样式、添加自定义的导航栏等等。

在项目的主文件中，我们需要引入fastapi和fastapi.staticfiles模块，然后修改app实例的一些配置。我们可以添加一个静态文件目录，将templates目录的路径作为参数传递给StaticFiles类的构造函数。这样，FastAPI就会在静态文件目录中查找我们自定义的模板文件。

接下来，我们需要修改app实例的docs_url和redoc_url属性，将它们的值改为我们自定义的路径。例如，我们可以将docs_url设置为/custom-docs，将redoc_url设置为/custom-redoc。这样，生成的文档就可以通过这些路径访问。

最后，我们需要重新运行项目，使更改生效。在命令行中输入以下命令：

uvicorn main:app --reload

现在，我们可以通过访问http://localhost:8000/custom-docs来查看我们自定义的文档页面了。

总结来说，要将FastAPI生成的文档更换为自定义的样式和布局，我们需要创建一个templates目录，编写一个index.html文件作为自定义的文档主页，并修改app实例的一些配置。然后重新运行项目，即可查看自定义的文档页面。这样，我们就能够根据自己的需求定制FastAPI生成的API文档了。