### 如何搭建和安装 FastAPI 的运行环境 #### 1. 虚拟环境的创建 为了确保项目的依赖管理清晰，建议先创建一个 Python 虚拟环境。以下是具体操作方法： 通过命令行工具执行以下指令来安装虚拟环境所需的库[^3]： ```bash pip install virtualenv pip install virtualenvwrapper-win ``` 接着可以创建一个新的虚拟环境并激活它： ```bash virtualenv my_fastapi_env my_fastapi_env\Scripts\activate ``` 这一步骤有助于隔离不同项目之间的依赖关系。 #### 2. 安装 FastAPI 和 ASGI 服务器 一旦虚拟环境被成功激活，就可以继续安装 FastAPI 及其推荐使用的 ASGI 服务器 Uvicorn 或 Hypercorn 来处理 HTTP 请求。输入如下命令完成安装过程[^2]: ```bash pip install fastapi uvicorn ``` #### 3. 创建第一个 FastAPI 应用程序实例 下面是一个简单的例子展示如何快速启动一个基于 FastAPI 的 API 服务[^1]: ```python from fastapi import FastAPI app = FastAPI() @app.get("/") def read_root(): return {"message": "Welcome to your first FastAPI app!"} ``` 保存这段代码到文件 `main.py` 中之后，可以通过终端运行此应用： ```bash uvicorn main:app --reload ``` 这里的参数解释为：指定模块名 (`main`) 和对象名 (`app`) 组成的应用入口位置；`--reload` 参数表示当源码发生变化时自动重启服务器以便于开发调试阶段使用。 #### 4. 测试接口是否正常工作 打开浏览器访问 http://127.0.0.1:8000 ，如果一切设置无误，则应该能看到返回的消息：“{'message': 'Welcome to your first FastAPI app!'}”。 --- ### 注意事项 - 如果遇到任何错误提示，请确认已正确安装所有必要组件以及检查网络连接状态。 - 推荐阅读官方文档获取更多高级特性和最佳实践指导链接[^1]。