企业级FastAPI后端模板搭建（一）初始化项目

企业级FastAPI后端模板搭建（一）

• 初始化项目
• • 安装虚拟环境
  • 安装FastAPI和Uvicorn
  • 创建FastAPI应用
  • 运行FastAPI应用

初始化项目

在合适的目录创建一个文件夹， 我创建的文件夹 名称是fastapi-template 。

安装虚拟环境

进入项目文件夹，然后创建虚拟环境：

# 创建虚拟环境
python -m venv .venv

虚拟环境创建完成之后，进行激活：

# 激活 python 虚拟环境
.venv\Scripts\activate

注意：虚拟环境只需要在初始化的时候创建一次，之后每次启动项目只需要进行虚拟环境激活即可

安装FastAPI和Uvicorn

首先，你需要安装FastAPI和Uvicorn（一个ASGI服务器，用于运行FastAPI应用）。

打开你的终端或命令提示符，并运行以下命令：

pip install fastapi uvicorn

创建FastAPI应用

接下来，创建一个新的Python文件（例如main.py），并开始编写FastAPI应用。

main.py

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
    return {"Hello": "World"}

运行FastAPI应用

使用Uvicorn来运行你的FastAPI应用。在终端中运行以下命令：

uvicorn main:app --reload

命令说明：

main ：是你的 Python 文件名（不带 .py 后缀）

app ：是 FastAPI 实例的名称

--reload：开启热重载，修改代码后自动重启（适合开发阶段）

打开浏览器访问 http://127.0.0.1:8000/，你会看到浏览器页面显示返回的 JSON 数据：

FastAPI 默认会根据函数签名自动生成 API 文档，非常适合调试和接口分享。

FastAPI 提供了两种风格的 API 文档：

http://127.0.0.1:8000/docs ：交互式 API 文档（Swagger UI）。

http://127.0.0.1:8000/redoc ：另一种风格的 API 文档（ReDoc），更适合查阅与归档。