### 使用 Python、Uvicorn 和 FastAPI 创建 HTTP 接口 #### 安装依赖库 为了创建并运行基于 FastAPI 的应用，需先安装 `fastapi` 及 `uvicorn`。这可以通过 pip 命令完成： ```bash pip install fastapi uvicorn ``` 此命令会下载并安装所需的全部包[^1]。 #### 编写 FastAPI 应用程序 ##### 处理表单数据 (form-data) 当处理文件上传或多部分表单时，可以利用 `UploadFile` 类型以及 `Form` 参数来接收来自客户端的数据。下面是一个简单的例子展示如何实现这一点： ```python from fastapi import FastAPI, File, Form, UploadFile import shutil app = FastAPI() @app.post("/upload/") async def upload_file(file: UploadFile = File(...), description: str = Form(None)): with open(f"./{file.filename}", "wb") as buffer: shutil.copyfileobj(file.file, buffer) return {"filename": file.filename, "description": description} ``` 这段代码定义了一个 POST 路由 `/upload/` ，它接受一个名为 `file` 的文件对象和可选字段 `description` 。接收到的文件会被保存到服务器本地磁盘上，并返回所给定描述信息及文件名作为响应体[^2]。 ##### 解析 URL 编码参数 (x-www-form-urlencoded) 对于传统的 HTML 表单提交方式（即 Content-Type 为 application/x-www-form-urlencoded），可以直接通过函数形参获取这些键值对形式的数据项： ```python from fastapi import FastAPI, Form app = FastAPI() @app.post("/submit_form/") async def handle_form(username: str = Form(...), password: str = Form(...)): return {"username": username, "password": password} ``` 在此示例中，路径 `/submit_form/` 将等待两个必填字段——用户名 (`username`) 和密码 (`password`) ——并通过它们构建 JSON 格式的回复消息发送回前端。 #### 启动应用程序 编写好 API 后，在项目根目录下执行如下指令启动服务端监听进程： ```bash uvicorn your_module_name:app --reload ``` 这里的 `your_module_name` 是指包含上述代码逻辑的那个 .py 文件去掉扩展名后的名称；而 `--reload` 开关则允许开发者模式下的热更新功能以便于调试期间自动重启 web server 实例。