两小时快速入门 FastAPI–第一回一、FastAPI 简介FastAPI 是一个用于开发 Web API 的 Python 框架。它的主要特点是编写简单支持 Python 类型注解自动进行参数校验自动生成接口文档适合前后端分离、AI 服务和内部接口开发FastAPI 项目启动后可以通过下面的地址查看接口文档http://127.0.0.1:8000/docs二、本次任务目标本次练习主要完成以下内容使用uv创建 FastAPI 项目安装 FastAPI启动 FastAPI 服务编写两个简单的 GET 接口学习路径参数和查询参数的使用三、完成任务的整个流程1. 创建项目在 PowerShell 中新建练习目录mkdirfastapi-2hcdfastapi-2h uv init uvaddfastapi[standard]其中uv init初始化 Python 项目uv add fastapi[standard]安装 FastAPI 和常用依赖2. 编写代码打开项目中的main.py写入以下代码fromfastapiimportFastAPI# 创建 FastAPI 应用实例并设置接口文档中显示的标题。appFastAPI(title我的两个小时FastAPI练习)# 定义根路径接口当访问 http://127.0.0.1:8000/ 时会执行这个函数。app.get(/)defroot():# 返回一个 JSON 数据表示 FastAPI 服务已经启动。return{message:FastAPI 已经启动}# 定义带路径参数的接口name 从 URL 路径中读取age 从查询参数中读取。# 例如/hello/张三?age18app.get(/hello/{name})defsay_hello(name:str,age:int|NoneNone):# 返回问候信息并把传入的年龄一并返回。return{message:f你好{name},age:age}结果如图所示代码中一共定义了两个接口。第一个接口GET /访问http://127.0.0.1:8000/返回{message:FastAPI 已经启动}第二个接口GET /hello/{name}访问http://127.0.0.1:8000/hello/张三?age18其中张三是路径参数name18是查询参数age返回结果{message:你好张三,age:18}3. 启动项目在 PowerShell 中执行uv run fastapi dev main.py这是 FastAPI 开发环境下常用的启动方式。其中uv run在当前 uv 项目环境中运行命令fastapi dev以开发模式启动 FastAPImain.py指定项目入口文件启动成功后访问http://127.0.0.1:8000接口文档地址为http://127.0.0.1:8000/docs四、总结本次练习完成了一个基础的 FastAPI 项目。通过这次练习主要学习了使用uv初始化项目和安装依赖创建 FastAPI 应用编写 GET 接口使用路径参数和查询参数启动 FastAPI 开发服务器使用/docs测试接口这是 FastAPI 最基础的使用方式后续可以继续学习 POST 请求、Pydantic 数据模型、数据库连接和项目路由拆分。
