FastAPI安装报python-multipart构建wheel失败、uvicorn找不到怎么办

两个报错是连锁触发的：

1. 安装fastapi[all]时出现的error: invalid command 'bdist_wheel'，是当前Python环境缺少wheel包构建组件导致的，直接造成依赖python-multipart安装失败，整个fastapi[all]依赖链安装中途终止。
2. 由于全量依赖未完成安装，本应随FastAPI一同部署的uvicorn实际并未写入虚拟环境，因此触发命令不存在的提示。不要执行sudo apt install uvicorn安装系统源版本，系统级uvicorn和venv虚拟环境完全隔离，无法调用虚拟环境内的FastAPI依赖，安装后也无法正常运行项目

• 第一步：确认已经激活目标venv虚拟环境，激活成功后终端行首会出现(my_venv)的环境标识
  • Linux/macOS激活命令：source venv/my_venv/bin/activate
  • Windows cmd激活命令：venv\my_venv\Scripts\activate.bat
  • Windows PowerShell激活命令：venv\my_venv\Scripts\Activate.ps1
    激活后执行pip -V检查路径，输出的pip路径必须指向你创建的my_venv目录，避免包装到全局Python环境。
• 第二步：安装缺失的构建依赖，升级基础包管理组件，执行命令：

pip install --upgrade pip setuptools wheel

• 第三步：清理之前安装失败的残留包，重新执行FastAPI全量安装：

pip uninstall -y fastapi uvicorn python-multipart
pip install "fastapi[all]"

• 第四步：验证安装结果，执行uvicorn --version，如果正常输出版本号，就可以直接运行uvicorn main:app --reload启动服务。

如果执行完上述步骤仍然提示uvicorn命令找不到，可以直接通过Python模块方式调用，跳过系统路径查找逻辑，只要虚拟环境内安装了uvicorn就可以正常运行：

python -m uvicorn main:app --reload

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