10分钟用FastAPI搭建第一个REST API:新手一步步教程
本文手把手教你安装FastAPI、编写第一个API、运行并测试,零基础也能在10分钟内跑通。
想自己搭一个后端API,但觉得很难?其实用FastAPI(一个帮你快速写API的Python工具)只要10分钟。下面一步步来。
准备工作:装好Python和编辑器
- Python:去官网 python.org 下载3.8或更高版本,安装时记得勾选“Add Python to PATH”。
- 代码编辑器:推荐VS Code(免费),下载后装Python插件。
- 终端:Windows用CMD或PowerShell,Mac/Linux用终端。
安装FastAPI和服务器
- 打开终端,输入:
pip install fastapi uvicorn(pip是Python的安装工具,uvicorn是运行FastAPI的服务器)。 - 等待安装完成,看到successfully表示成功。
写第一个API代码
- 新建一个文件夹,里面新建文件
main.py。 - 复制以下代码进去:
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"Hello": "World"}
- @app.get("/") 意思是:当有人访问你的网址根目录时,执行下面的函数。
- 函数返回一个JSON(一种数据格式),浏览器会显示
{"Hello": "World"}。
运行并测试
- 在终端里,进入
main.py所在文件夹,输入:uvicorn main:app --reload。 - 看到“Uvicorn running on http://127.0.0.1:8000”就成功了。
- 打开浏览器,访问 http://localhost:8000,你会看到
{"Hello": "World"}。 - 再访问 http://localhost:8000/docs,会出现漂亮的交互式API文档页面,可以在这里测试你的API。
常见坑提醒
- 如果
pip报错,试试python -m pip install fastapi uvicorn。 - 如果端口被占用,可以在命令后加
--port 8001换一个端口。
现在你已经有第一个API了!接下来可以尝试添加更多路径,比如 /items,返回列表数据。FastAPI会自动生成文档,非常方便。享受编程吧!
内容来源
DEV Tutorial
发布时间
2026-05-12 01:32