极客前沿

10分钟用FastAPI搭建第一个REST API:新手一步步教程

2026-05-12 01:32
DEV Tutorial
查看原文

本文手把手教你安装FastAPI、编写第一个API、运行并测试,零基础也能在10分钟内跑通。

想自己搭一个后端API,但觉得很难?其实用FastAPI(一个帮你快速写API的Python工具)只要10分钟。下面一步步来。

Tutorial Image

准备工作:装好Python和编辑器

  • Python:去官网 python.org 下载3.8或更高版本,安装时记得勾选“Add Python to PATH”。
  • 代码编辑器:推荐VS Code(免费),下载后装Python插件。
  • 终端:Windows用CMD或PowerShell,Mac/Linux用终端。

安装FastAPI和服务器

  1. 打开终端,输入:pip install fastapi uvicornpip是Python的安装工具,uvicorn是运行FastAPI的服务器)。
  2. 等待安装完成,看到successfully表示成功。

写第一个API代码

  1. 新建一个文件夹,里面新建文件 main.py
  2. 复制以下代码进去:
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}
  • @app.get("/") 意思是:当有人访问你的网址根目录时,执行下面的函数。
  • 函数返回一个JSON(一种数据格式),浏览器会显示 {"Hello": "World"}

运行并测试

  1. 在终端里,进入 main.py 所在文件夹,输入:uvicorn main:app --reload
  2. 看到“Uvicorn running on http://127.0.0.1:8000”就成功了。
  3. 打开浏览器,访问 http://localhost:8000,你会看到 {"Hello": "World"}
  4. 再访问 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

返回 AI技术