FastAPI 入门（一）：环境准备与安装

这篇文章主要记录如何在本地搭建 FastAPI 的开发环境，并完成基本安装与验证。

一、FastAPI 是什么？

FastAPI 是一个基于 Python 的现代 Web 框架，特点是：

• 性能高（基于 Starlette 和 Pydantic）
• 使用类型注解，开发体验好
• 自带自动生成的接口文档（Swagger / OpenAPI）

二、准备 Python 环境

1. 确认已安装 Python 3.8 及以上版本：

python --version

如果还没有安装，可以到官网 https://www.python.org/ 下载并安装最新的 Python 版本，记得勾选 “Add Python to PATH”。

2. 创建项目目录（示例）：

mkdir fastapi-demo
cd fastapi-demo

3. 创建并激活虚拟环境（推荐做法）：

python -m venv venv

• Windows：

venv\Scripts\activate

• macOS / Linux：

source venv/bin/activate

终端前面出现 (venv) 说明虚拟环境已激活。

三、安装 FastAPI 和 Uvicorn

FastAPI 本身只是框架，还需要一个 ASGI 服务器（比如 Uvicorn）来运行。

在虚拟环境中执行：

pip install "fastapi[all]" "uvicorn[standard]"

说明：

• fastapi[all] 会安装 FastAPI 以及一些常用可选依赖（比如用于文档和表单解析的库）
• uvicorn[standard] 是推荐的运行 FastAPI 的 ASGI 服务器

安装完成后，可以简单检查一下：

pip show fastapi
pip show uvicorn

若能看到版本信息，说明安装成功。

四、编写第一个 FastAPI 程序

在项目根目录下新建 main.py，内容如下：

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello FastAPI"}

解释：

• 创建了一个 FastAPI 实例 app
• 使用 @app.get("/") 装饰器定义了一个 GET 路由 /
• 访问根路径时，会返回一个 JSON：{"message": "Hello FastAPI"}

五、运行项目并验证

在项目目录下运行：

uvicorn main:app --reload

含义：

• main：指的是 main.py 这个模块
• app：指的是文件中定义的 app = FastAPI() 实例
• --reload：代码变更后自动重启服务，开发阶段非常方便

如果一切正常，你会在终端看到类似输出：

INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

此时在浏览器访问：

• http://127.0.0.1:8000/
  可以看到返回：

{"message": "Hello FastAPI"}

• http://127.0.0.1:8000/docs
  可以看到 FastAPI 自动生成的 Swagger 文档页面。

至此，FastAPI 的基础安装和最小示例就完成了。下一篇我们来看看如何定义更多的路由（包括路径参数和查询参数）。