5 安装与配置之安装FastAPI

在上一篇中，我们讨论了安装与配置FastAPI所需的“系统要求”。现在，我们将正式开始安装FastAPI。FastAPI是一个用于构建API的现代Web框架，能够提供极高的性能和简洁的代码结构。接下来，我们将通过几个简单的步骤来完成FastAPI的安装过程。

安装FastAPI

1. 创建虚拟环境（可选）

为了避免与系统中其他Python项目的冲突，建议在虚拟环境中安装FastAPI。首先，您需要确保您的机器上已安装Python。接下来，可以使用venv模块来创建一个虚拟环境。

在终端中运行以下命令：

python -m venv fastapi-env

激活虚拟环境：

• 在Windows上：

fastapi-env\Scripts\activate

• 在macOS或Linux上：

source fastapi-env/bin/activate

2. 安装FastAPI

在激活了虚拟环境后，接下来可以使用pip快速安装FastAPI。运行以下命令：

pip install fastapi

安装完成后，您可以验证FastAPI是否成功安装。可以通过以下命令查看已安装的包：

pip show fastapi

如果成功安装，您将看到与FastAPI相关的信息，例如版本号和安装位置。

3. 测试FastAPI的安装

为了验证FastAPI是否正常工作，我们可以创建一个简单的应用程序进行测试。在项目目录下新建一个文件，比如叫main.py，并添加以下代码：

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello, FastAPI!"}

4. 运行FastAPI应用

虽然FastAPI可以直接运行，但它本身并没有自带服务器，我们将在下一篇中安装Uvicorn作为服务器。但在这里，我们可以使用Uvicorn来运行FastAPI应用，但我们需要先安装它。

在继续之前，确保您在终端中处于虚拟环境下，接着运行以下命令来安装Uvicorn：

pip install "uvicorn[standard]"

一旦安装完成，使用以下命令来运行main.py文件：

uvicorn main:app --reload

这条命令的含义如下：

• main是您创建的Python文件名（不带.py后缀）。
• app是您在文件中创建的FastAPI实例。
• --reload参数使开发更方便，应用会在您修改代码后自动重启。

如果一切正常，您将在终端中看到如下输出：

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

5. 访问应用

在浏览器中访问 http://127.0.0.1:8000，您将看到以下JSON响应：

{"message": "Hello, FastAPI!"}

此外，FastAPI还拥有自动生成的API文档，您可以通过访问 http://127.0.0.1:8000/docs 来查看它。

总结

在这一节中，我们成功安装了FastAPI并创建了一个简单的API应用。通过设置虚拟环境、安装FastAPI以及测试基本功能，您现在能掌握基本的安装步骤。接下来，我们将介绍如何安装并配置Uvicorn，为我们的FastAPI应用提供高性能的可部署环境。

请继续关注下一篇教程，了解如何安装和配置Uvicorn，以便更好地运行您的FastAPI应用。