设置开发环境是使用 FastAPI 构建 API 的一个基础步骤。这包括确保您安装了正确的 Python 版本,并安装了必要的库:FastAPI 本身以及一个像 Uvicorn 这样的 ASGI 服务器来运行您的应用程序。我们还将采用使用虚拟环境来清晰地管理项目依赖的良好做法。本课程假定您已安装 Python 3.7 或更高版本。FastAPI 使用了现代 Python 特性,例如类型提示和异步编程,这些功能需要较新的版本。您可以通过打开终端或命令提示符并运行以下命令来检查您的 Python 版本:python --version # 或有时是 python3 --version如果您需要安装或更新 Python,请访问 Python 官方网站 (https://www.python.org/) 并按照您操作系统的说明进行操作。使用虚拟环境强烈建议为每个 Python 项目使用虚拟环境。虚拟环境会生成独立的区域,您可以在其中安装特定版本的包,而不会影响全局 Python 安装或其他项目。这可以避免依赖冲突,并使您的项目可复现。Python 附带 venv 模块,用于生成虚拟环境。进入您的项目目录: 打开终端,切换到您想创建 FastAPI 项目的目录。mkdir fastapi-ml-intro cd fastapi-ml-intro创建虚拟环境: 运行 venv 模块,为您的环境指定一个名称(常见约定是 .venv 或 venv)。python -m venv .venv # 或 python3 -m venv .venv此命令会创建一个 .venv 目录,其中包含 Python 解释器的副本和用于安装项目特定包的位置。激活虚拟环境: 激活会修改您 shell 的路径,以优先使用该环境的 Python 解释器和包。在 macOS 和 Linux 上:source .venv/bin/activate在 Windows 上(命令提示符):.venv\\Scripts\\activate.bat在 Windows 上(PowerShell):.venv\\Scripts\\Activate.ps1(您可能需要先调整执行策略:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process)激活后,您的终端提示符通常会显示环境的名称(例如,(.venv) your-user@your-machine:...$)。所有后续的 pip 安装都将在此独立环境中进行。要取消激活,只需键入 deactivate。安装 FastAPI 和 Uvicorn虚拟环境激活后,您现在可以使用 Python 的包安装器 pip 来安装 FastAPI 和 Uvicorn。FastAPI: 核心 Web 框架。Uvicorn: 一个 ASGI(异步服务器网关接口)服务器。FastAPI 基于 ASGI 标准构建,Uvicorn 是 FastAPI 作者推荐的,用于开发和生产的快速服务器程序。通过一个命令安装两者:pip install "fastapi[all]"[all] 选项是 FastAPI 提供的一种便捷方式。它会安装 fastapi 本身、用于服务的 uvicorn、用于数据验证的 pydantic(FastAPI 大量依赖此库),以及其他一些通常有用的可选依赖项(如用于表单数据的 python-multipart、用于模板的 jinja2 等)。这可以保证您有一个全面的起始点。如果您偏好最小化安装,可以单独安装它们:pip install fastapi uvicorn pydantic然而,对于初学者来说,通常建议使用 fastapi[all]。验证安装要确认 FastAPI 和 Uvicorn 已正确安装,您可以让 pip 显示它们的详细信息:pip show fastapi uvicorn此命令将显示有关已安装包的信息,包含它们的版本。请确保没有报告任何错误。开发工具虽然不是严格要求,但使用一个好的代码编辑器或 IDE(集成开发环境)将大大提升您的开发体验。Visual Studio Code (VS Code)、PyCharm、Sublime Text 或其他选项都提供了语法高亮、代码补全、调试和终端集成等功能,这些在与 FastAPI 等框架配合使用时非常实用。您的开发环境现已准备就绪。您已拥有 Python、FastAPI、Uvicorn 和一个独立的虚拟环境。在下一节中,您将使用此配置来创建并运行您的第一个简单 FastAPI 应用程序。