VS 2022中如何通过Python运行FastAPI的Uvicorn服务器？

第一步：确认虚拟环境激活状态与依赖安装 #

• 打开VS2022的Python项目后，先在解决方案资源管理器中右键项目，选择「Python环境」，确认选中的是你配置的Python3.9虚拟环境（而非全局Python）。
• 在VS2022自带的「Python终端」中重新安装依赖（避免之前误装到全局环境）：

  pip install fastapi uvicorn
  

第二步：修正Uvicorn启动命令 #

你之前用的uvicorn -m main:app --reload存在语法错误，正确的启动命令是：

uvicorn main:app --reload

（-m参数用于运行Python模块，此处直接指定模块名main加应用实例app即可）

第三步：在VS2022中配置一键启动 #

更高效的方式是直接在VS2022中配置启动项：

1. 点击菜单栏「调试」→「启动调试」旁的下拉箭头→「添加配置」
2. 选择「Python」→「FastAPI」模板（若无则选「Python通用」）
3. 在生成的launch.json中修改配置为：

   {
       "name": "FastAPI",
       "type": "python",
       "request": "launch",
       "module": "uvicorn",
       "args": [
           "main:app",
           "--reload"
       ],
       "jinja": true,
       "justMyCode": true,
       "python": "${command:python.interpreterPath}"
   }
   

4. 保存后点击启动按钮，即可直接运行Uvicorn服务器

第四步：解决DOS命令行模块找不到问题 #

若需用DOS命令行启动，必须先激活虚拟环境：

1. 找到虚拟环境的Scripts目录（比如虚拟环境名为venv，路径为项目目录\venv\Scripts）
2. 在DOS窗口执行激活命令：

   venv\Scripts\activate.bat
   

3. 激活成功后再执行uvicorn main:app --reload，即可正常识别模块

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