Windows 10下安装Uvicorn后无法通过命令行启动的问题求助

问题原因分析 #

你遇到的情况是Uvicorn模块已成功安装（能import uvicorn）但未生成uvicorn.exe可执行文件，大概率是以下原因：

• pip与当前使用的Python版本不匹配，导致安装路径错误
• Windows权限限制，安装时无法向C:\Python310\Scripts目录写入文件
• pip版本过旧，无法正确生成命令行可执行脚本

解决办法 #

1. 直接用Python模块方式启动（最快临时方案）
   不需要依赖uvicorn.exe，直接通过Python调用Uvicorn模块：

   python -m uvicorn my_app:app
   

   这是最稳妥的方式，绕过可执行文件缺失的问题。

2. 强制重新安装并指定Python版本
   先确认当前pip所属的Python版本，执行：

   pip --version
   

   输出路径如果不是C:\Python310\Lib\site-packages，说明用了其他Python的pip。此时用指定版本的Python重新安装：

   python -m pip install --force-reinstall uvicorn[standard]
   

   或者明确指定Python版本：

   py -3.10 -m pip install --force-reinstall uvicorn[standard]
   

3. 升级pip后重新安装
   旧版pip可能存在生成脚本的bug，先升级pip：

   python -m pip install --upgrade pip
   

   升级完成后再重新安装Uvicorn。

4. 以管理员权限执行安装
   右键命令提示符或PowerShell，选择「以管理员身份运行」，再执行安装命令，避免权限不足导致无法写入Scripts目录。

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