vscode python环境配置fastqpi

### 如何在 VSCode 中配置 Python 环境用于 FastAPI 开发

#### 安装必要的扩展
为了更好地支持 Python 及 FastAPI 的开发，在 Visual Studio Code (VSC) 中应安装特定的扩展来提升编码体验。推荐安装如下两个主要插件：

- **Python 插件**：此插件提供了对 Python 语言的支持，包括 IntelliSense、linting、调试等功能[^2]。

{
    "recommendations": [
        "ms-python.python"
    ]
}

- **Pylance**：这是一个强大的语言服务器，能够显著提高代码补全的速度和准确性，增强开发者编写高效代码的能力。

{
    "recommendations": [
        "ms-python.vscode-pylance"
    ]
}

#### 创建并激活虚拟环境
对于任何基于 Python 的项目来说，使用独立的虚拟环境是非常重要的做法之一。可以利用 `venv` 或者其他类似的工具如 `conda` 来创建一个新的虚拟环境[^1]。

# 使用 venv 创建名为 'fastapi_env' 的新虚拟环境
python -m venv fastapi_env

# 激活该虚拟环境（Windows）
.\fastapi_env\Scripts\activate.bat

# 激活该虚拟环境（macOS/Linux）
source fastapi_env/bin/activate

一旦激活了新的虚拟环境，则可以在其中安全地安装所需的依赖项而不会影响全局 Python 设置。

#### 安装 FastAPI 和 Uvicorn
接下来需要安装 FastAPI 库及其 ASGI 服务器 uvicorn，以便运行应用程序实例。

pip install fastapi[all]
pip install "uvicorn[standard]"

上述命令会下载并安装最新版本的 FastAPI API 框架及相关组件，同时也设置了默认的异步 HTTP 服务器——Uvicorn。

#### 调试配置
为了让调试更加方便快捷，应该设置好 VSC 内建调试器的相关参数。可以通过 `.vscode/launch.json` 文件来进行具体设定。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Run FastAPI App",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/main.py", // 主文件路径
            "args": ["--reload"],                    // 自动重启选项
            "jinja": true,
            "console": "integratedTerminal",
            "justMyCode": false                      // 是否只跟踪用户代码
        }
    ]
}

以上 JSON 片段定义了一个启动配置，它允许一键执行带有热重载特性的 FastAPI 应用程序，并且可以选择性开启或关闭仅限于个人编写的源码追踪模式。

#### 推荐的项目结构
构建一个清晰合理的目录布局有助于维护项目的可读性和模块化程度。下面给出了一种可能适用的 FastAPI 项目基本框架：

my_fastapi_project/
│── .gitignore          # Git忽略列表
│── main.py             # 启动入口脚本
│── app/
│   ├── __init__.py     # 初始化包标志
│   ├── routers/        # 存放路由处理函数
│       └── items.py    
│   ├── models/         # 数据模型类定义
│       └── item_model.py  
│   ├── dependencies/   # 外部服务接口封装
│       └── database.py 
└── tests/              # 测试套件所在位置

这种分层设计使得不同职责的功能被合理分离出来，便于后续迭代升级时定位修改点。