如何解决FastAPI创建时出现的“uvicorn: command not found”错误

• 检查pip安装路径是否在系统环境变量PATH中

  1. 执行pip show uvicorn，找到输出里的Location字段，定位到uvicorn脚本所在的bin目录（Linux/macOS一般是~/.local/bin或/usr/local/bin，Windows是Python安装目录下的Scripts文件夹）
  2. 执行echo $PATH（Linux/macOS）或echo %PATH%（Windows），确认上述bin目录是否在输出的路径列表中
  3. 若不在，手动添加：
     • Linux/macOS：临时生效可执行export PATH="$HOME/.local/bin:$PATH"；永久生效则编辑~/.bashrc或~/.zshrc，加入该命令后执行source ~/.bashrc（或对应配置文件）
     • Windows：打开「此电脑→属性→高级系统设置→环境变量」，在用户变量的PATH中添加Python的Scripts路径，比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python38\Scripts

• 直接通过Python模块方式运行uvicorn
  无需依赖系统PATH，执行python -m uvicorn main:app --reload即可调用当前Python环境中的uvicorn模块

• 确认pip与Python版本匹配
  执行pip --version，查看输出的Python版本是否为3.8.9；若不匹配，用对应版本的Python重新安装：

  python3.8 -m pip install uvicorn
  

  之后用python3.8 -m uvicorn main:app --reload启动服务

• 检查虚拟环境状态（若使用虚拟环境）
  确保已激活目标虚拟环境：

  • Linux/macOS：source 虚拟环境目录/bin/activate
  • Windows：虚拟环境目录\Scripts\activate
    激活后再执行安装和启动命令

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