如何查看Uvicorn的版本号-Python教程-PHP中文网

uvicorn --version 仅显示主版本和python版本，无法反映依赖状态；需组合命令验证uvloop、httptools等关键依赖是否就绪，否则可能静默降级影响性能。

如何查看uvicorn的版本号

直接运行 uvicorn --version 就能拿到主版本号，但这个命令不显示依赖版本，也看不出是否安装了 [standard] 扩展。

为什么 `uvicorn --version` 有时不准或报错

常见现象是终端输出 command not found: uvicorn 或 ModuleNotFoundError，本质不是命令写错，而是当前 Python 环境没装、装错解释器、或装了但没进 PATH。

虚拟环境未激活时，在系统 Python 下装了 uvicorn，但你在 venv 里运行 —— 找不到
用 pip3 install uvicorn 装到了 Python 3.9 环境，但你用 python3.11 -m uvicorn 启动 —— 解释器不匹配
装了 uvicorn[standard]，但 --version 输出里不体现 uvloop 或 httptools 是否就绪，得额外验证

确认完整安装状态：查主版本 + 关键依赖

只靠 uvicorn --version 不够。要快速判断实际运行时行为（比如是否真用了 uvloop），得组合查：

Uvicorn 0.52.1

Uvicorn 0.52.1 是 Python ASGI Web 服务器，提供异步应用服务及 WebSocket 支持，常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包，可使用 pip 安装，并由包管理器处理所需依赖。

下载

运行 uvicorn --version → 看主版本和 Python 版本（如 uvicorn 0.29.0 [Python 3.11.9]）
紧接着运行 python -c "import uvicorn; print(uvicorn.__version__)"; python -c "import uvloop; print('uvloop OK')" → 验证模块可导入且关键依赖存在
若报 ModuleNotFoundError: No module named 'uvloop'，说明没装 [standard]，性能会打折扣

在代码里动态获取版本信息

如果你在 FastAPI 或 Starlette 项目里需要做兼容性判断（比如某些 API 在 uvicorn 下不可用），别硬编码字符串比对，直接读属性：

import uvicorn
print(uvicorn.__version__)  # 字符串，如 "0.29.0"
print(uvicorn.version.VERSION)  # 同上，等价

注意：uvicorn.version 是模块，不是函数；uvicorn.VERSION 不存在 —— 容易拼错成 uvicorn.VERSION 导致 AttributeError。

真正容易被忽略的是：Uvicorn 的行为不仅取决于自身版本，更受 uvloop 和 httptools 是否就位影响。哪怕 --version 显示正常，缺了其中一个，启动时可能静默降级为 asyncio 默认事件循环，吞吐量直接掉一档。动手前先 python -c "import uvloop, httptools" 过一遍，比什么都实在。