VS Code调试FastAPI时出现Jinja2未安装断言错误的问题

核心原因 #

调试器未使用你项目的虚拟环境Python解释器，导致加载的环境中没有安装Jinja2，和命令行启动时的环境不一致。

解决方法 #

• 确认VS Code使用的Python解释器
  点击VS Code左下角状态栏的Python版本标识，切换到你项目的虚拟环境解释器（路径一般是项目根目录/.venv/bin/python，Windows系统为项目根目录\.venv\Scripts\python.exe）

• 修正launch.json配置
  确保配置里指定虚拟环境的Python路径，示例配置如下：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: FastAPI",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "python": "${workspaceFolder}/.venv/bin/python", // Windows替换为\.venv\Scripts\python.exe
              "console": "integratedTerminal"
          }
      ]
  }
  

• 验证环境一致性
  在VS Code集成终端中激活虚拟环境，执行pip freeze确认Jinja2 3.1.2已存在，确保终端和调试器使用同一环境。

内容的提问来源于stack exchange，提问作者sbiel