FastAPI 安装指南（中文）

以下是 完整、详细、一步步 的 FastAPI 安装方法，适用于 Windows / macOS / Linux。

---

一、安装 Python（前提）

FastAPI 要求 Python 3.7 或更高版本（推荐 3.9+）

1. 检查 Python 版本

python --version
# 或
python3 --version

建议输出：Python 3.9.0 或更高

---

2. 如果没有安装 Python

系统	下载地址
Windows	https://www.python.org/downloads/windows/
macOS	https://www.python.org/downloads/macos/ 或使用 Homebrew
Linux	使用包管理器（如 apt, yum, dnf）

推荐使用官方安装器或 pyenv 管理多个版本

---

二、推荐：使用虚拟环境（强烈建议）

避免依赖冲突，保持项目干净。

方法 1：使用 venv（内置）

# 创建项目文件夹
mkdir my_fastapi_project
cd my_fastapi_project

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate

# macOS / Linux:
source venv/bin/activate

激活后提示符会变成 (venv)

方法 2：使用 pipenv（推荐高级用户）

pip install pipenv
pipenv install fastapi uvicorn
pipenv shell

---

三、安装 FastAPI 和 Uvicorn

pip install fastapi uvicorn[standard]

uvicorn[standard] 包含了 uvloop 和 httptools，性能更高（Linux/macOS 推荐）

---

四、验证安装成功

1. 创建 main.py

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def home():
    return {"message": "FastAPI 安装成功！"}

2. 运行服务器

uvicorn main:app --reload

--reload：开发时自动重载（推荐）

---

3. 访问测试

打开浏览器访问：

• API 地址：http://127.0.0.1:8000
  → 返回：{"message": "FastAPI 安装成功！"}
• 自动文档（Swagger UI）：http://127.0.0.1:8000/docs
• ReDoc 文档：http://127.0.0.1:8000/redoc

---

五、可选：安装完整依赖（一键安装）

pip install "fastapi[all]"

包含：uvicorn[standard], jinja2, python-multipart, email-validator 等
适合快速开发、学习、原型

---

六、常见问题解决

问题	解决方案
pip 命令未找到	安装 Python 时勾选 “Add Python to PATH”
uvicorn 命令未找到	重启终端，或确保在虚拟环境中
端口被占用	使用 --port 8001
安装慢	使用国内镜像：pip install fastapi -i https://pypi.tuna.tsinghua.edu.cn/simple

使用国内镜像加速（推荐）

pip install fastapi uvicorn -i https://pypi.tuna.tsinghua.edu.cn/simple

或配置永久镜像（pip config）：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

---

七、升级 FastAPI

pip install --upgrade fastapi uvicorn

---

八、完整安装脚本（一键运行）

# 创建并进入项目目录
mkdir fastapi-demo && cd fastapi-demo

# 创建虚拟环境并激活
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装 FastAPI
pip install fastapi uvicorn[standard]

# 创建 main.py
echo 'from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def home(): return {"message": "Hello FastAPI!"}' > main.py

# 启动服务
uvicorn main:app --reload

---

恭喜！你已成功安装 FastAPI！

现在你可以：

• 访问 http://127.0.0.1:8000 → 看到 JSON 响应
• 访问 http://127.0.0.1:8000/docs → 使用交互式 API 文档

---

下一步建议：

回复以下关键词获取更多教程：

关键词	内容
hello	第一个 Hello World 项目
crud	完整 CRUD 示例（带数据库）
docker	Docker 部署 FastAPI
auth	用户登录认证（JWT）

---

官方文档（中文）：https://fastapi.tiangolo.com/zh/
GitHub：https://github.com/tiangolo/fastapi

需要我帮你 生成一个完整可运行的项目模板 吗？回复 模板 获取！