安装与虚拟环境配置

欢迎来到FastAPI入门教程的第一部分！如果你是Python新手，但想尝试Web开发，这里是个完美的起点。本教程将手把手教你如何安装FastAPI并设置虚拟环境，确保你的学习过程顺利、有趣。

为什么需要虚拟环境？

想象一下，你在厨房做菜时，不同菜品需要不同的调料和工具。如果你把所有调料都混在一个大碗里，下次做别的菜时可能会一团糟。虚拟环境就是这样一个“独立的厨房”：它允许你为每个Python项目创建一个隔离的环境，避免不同项目的库互相干扰。例如，你可能有项目A需要FastAPI 0.68，而项目B需要FastAPI 0.70，虚拟环境能确保它们和谐共存。

简单目标：在这一节，我们将创建一个虚拟环境并安装FastAPI。完成后，你会运行一个简单的应用，看到它工作起来——这是你的第一个“成功时刻”！

步骤1：检查Python和pip

在开始之前，确保你电脑上安装了Python和pip（Python的包管理工具）。如果你还没有，可以去Python官网下载并安装最新版本。

打开你的终端或命令提示符（Windows用户可以搜索“cmd”，Mac或Linux用户可以打开“Terminal”），输入以下命令检查版本：

python --version
pip --version

如果看到类似“Python 3.x.x”和“pip xx.x”的输出，说明已经准备就绪！如果报错，你可能需要重新安装Python。别担心，这很正常——记得选择安装时勾选“Add Python to PATH”选项。

成功时刻：看到版本号输出时，给自己点个赞！你已经迈出了第一步。

步骤2：创建虚拟环境

现在，我们来创建虚拟环境。假设你正在学习FastAPI，我们创建一个名为fastapi_project的目录来存放项目。

在终端中，运行以下命令：

# 创建一个新目录
mkdir fastapi_project
# 进入该目录
cd fastapi_project
# 创建虚拟环境，我们命名为“venv”（这是个通用名字）
python -m venv venv

这会在当前目录下创建一个名为venv的文件夹。把它想象成你的“私人厨房”，里面准备好了Python和所有需要的工具。

步骤3：激活虚拟环境

创建好虚拟环境后，需要激活它才能使用。激活后，终端会显示环境名称，提示你现在在这个“厨房”里工作。

• 在Windows上：

  venv\Scripts\activate
  

• 在Mac或Linux上：

  source venv/bin/activate
  

运行后，你应该在终端看到类似(venv)的前缀。如果没有，检查你是否在正确目录下。

成功时刻：看到(venv)出现时，恭喜！你已经进入了虚拟环境，现在所有操作都限制在这个小世界里，不会影响其他项目。

步骤4：安装FastAPI

在虚拟环境中，我们可以安全地安装FastAPI。FastAPI是一个现代、快速的Web框架，我们需要一个服务器来运行它，所以也会安装Uvicorn（一个轻量级服务器）。

在终端中（确保有(venv)前缀），运行：

pip install fastapi uvicorn

这个命令会下载并安装FastAPI和Uvicorn。pip会自动处理依赖，就像网购时打包好所有必需品一样。完成后，你可以验证安装：

pip list

你会看到列表中包含fastapi和uvicorn，版本号显示出来。

成功时刻：看到FastAPI在列表中时，感觉就像收到了新工具包——一切就绪，准备开始构建！

步骤5：测试安装——你的第一个FastAPI应用

这是最激动人心的部分！我们将创建一个简单的FastAPI应用，运行它，并看到它工作。在项目目录下（还是在虚拟环境中），创建一个名为main.py的文件。

你可以用任何文本编辑器，比如记事本或VS Code。打开文件，输入以下代码：

from fastapi import FastAPI

app = FastAPI()

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

这段代码做了什么？

• 导入FastAPI库。
• 创建一个FastAPI应用实例。
• 定义一个路由：当访问主页（“/”）时，返回一个JSON消息{"Hello": "World"}。这就像给你的应用开了一扇门，访客敲门时你会回应。

保存文件后，在终端运行：

uvicorn main:app --reload

解释：

• main 指我们刚创建的main.py文件。
• app 是文件中的FastAPI实例。
• --reload 是开发时的便利选项，代码有改动时自动重启服务器。

运行后，你会看到输出类似：

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

现在，打开你的浏览器，输入地址 http://127.0.0.1:8000。你应该看到一个页面显示 {"Hello": "World"}。

成功时刻：看到这个页面时，欢呼吧！你已经成功安装FastAPI、配置虚拟环境，并运行了你的第一个Web应用。这就像点亮了一个灯泡——感觉超棒，对吗？

下一步

你已经完成了基础设置。以后每次工作在这个项目时，记得先激活虚拟环境（步骤3），然后开始编码。完成后，可以用 deactivate 命令退出虚拟环境。

保持信心，这只是开始！在后续教程中，我们会学习如何添加更多路由、处理数据等。如果有问题，随时回顾这些步骤——你已经证明了你能做到！

总结：我们创建了虚拟环境来隔离项目，安装了FastAPI和Uvicorn，并运行了一个简单应用。这种动手方式让你快速看到成果，建立学习Web开发的信心。