怎么用pip安装uvicorn

轻明姑娘_9282

轻明姑娘_9282

2026-09-02

666人浏览

原创

pip install uvicorn基础安装不足以支撑生产需求,因缺失uvloop、httptools、websockets、watchfiles等关键依赖,导致性能低下、WebSocket失效、热重载失灵等问题;推荐使用pip install "uvicorn[standard]"一次性安装完整依赖。

怎么用pip安装uvicorn

直接用 pip install uvicorn 就能装,但得看你要干啥

基础安装 pip install uvicorn 足够跑个 Hello World,但生产环境或需要 WebSocket、自动重载、高性能 HTTP 解析时,它缺关键依赖,会报错或性能拉胯。

为什么 pip install uvicorn 经常不够用

最小安装只含纯 Python 实现,不带:uvloop(Linux/macOS 下事件循环慢 2–3 倍)、httptools(HTTP 解析比纯 Python 快 5–10 倍)、websockets(没它 FastAPI 的 /ws 路由直接 404)、watchfiles(--reload 不生效)。

  • 运行 uvicorn main:app --reload 却不热重载?大概率缺 watchfiles
  • 启动时报 WebSocket upgrade request rejected?基本是没装 websockets
  • 压测时 CPU 持续 90%+,而别人同配置才 30%?可能没走 uvloop 或 httptools

推荐安装方式:用 pip install "uvicorn[standard]"

方括号里的 standard 是官方定义的 extras,会一并装上:uvloop、httptools、websockets>=10.4、watchfiles、click、h11 等。Windows 用户也能用,只是 uvloop 在 Windows 上会被跳过(改用内置 asyncio 事件循环)。

pipe
pipe

深入设计 GitHub Actions 工作流——涵盖触发策略、安全加固、性能优化、PR 自动化和可重用工作流设计。当需要新的 GHA 工作流设计或高级优化时使

下载
  • 命令必须加英文双引号或单引号,否则 shell 会把方括号当通配符解析失败
  • 如果提示 ERROR: Could not find a version that satisfies the requirement uvicorn[standard],先升级 pip:pip install -U pip
  • 验证是否装全:运行 python -c "import uvloop, httptools, websockets, watchfiles",不报错才算到位

Windows 下常见卡点

不是所有依赖都能在 Windows 上编译成功,尤其旧版 MSVC 或没装 C++ 构建工具时,httptools 和 uvloop 容易安装失败。

  • 优先用预编译 wheel:pip install --only-binary=all "uvicorn[standard]"
  • 若仍失败,可退一步:先 pip install uvicorn,再单独装 pip install websockets watchfiles,至少保 WebSocket 和热重载可用
  • uvloop 在 Windows 上非必需,asyncio 默认事件循环够用;但 Linux/macOS 生产环境务必让它生效

实际项目里,uvicorn[standard] 是默认起点。漏装一个依赖,可能到上线前夜才暴露——比如客户连不上 WebSocket,或者日志里满屏 RuntimeWarning: coroutine 'X' was never awaited,根源却是 watchfiles 没装导致 reload 机制异常触发。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

3710

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

8403

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

10142

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

5367

16

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 安装指南
Conan 2 安装指南

共0课时 | 0人学习

Python虚拟环境官方教程
Python虚拟环境官方教程

共0课时 | 0人学习

Python venv官方模块文档
Python venv官方模块文档

共0课时 | 0人学习