uv list 默认列出当前环境所有已安装包(package-name==version),不区分直接安装或依赖;无--direct等过滤参数,需通过安装前后diff或uv pip show查Required-by间接识别直接安装包。

uv list 列出已安装包的基本用法
直接运行 uv list 即可列出当前 Python 环境中所有已安装的包(包括依赖和直接安装的包),输出格式为 package-name==version,和 pip list 类似但更快。
注意:它默认作用于当前激活的虚拟环境或系统环境 —— 不会自动识别 venv 目录下的 pyvenv.cfg,所以确保你已经 source venv/bin/activate(Linux/macOS)或 venv\Scripts\activate(Windows)后再执行。
如何让 uv list 只显示直接安装的包(不含依赖)
uv list 本身不支持 --not-required 或 --user 这类过滤参数,它始终展示全部已安装包。如果你只想看“你主动装的”,得靠间接方式:
- 记录安装前后的差异:先
uv list --format=freeze > before.txt,再uv pip install requests,再uv list --format=freeze > after.txt,用diff before.txt after.txt查增量 - 配合
uv pip show查单个包来源:uv pip show requests输出里若有Required-by:字段,说明它是被其他包依赖的 - 目前没有等价于
pip list --not-required的原生 uv 命令,别在文档里找--direct参数 —— 它不存在
格式化与导出:--format 参数的实际效果
uv list 支持 --format,但选项非常有限:目前只接受 freeze(默认)和 markdown(仅用于生成简单表格,无交互能力)。
常见误区:
Python uv 0.12.20 是 Astral 开发的 Python 包与项目管理工具,支持依赖解析、虚拟环境、Python 版本及项目锁文件管理。本下载包适用于 Windows x64,解压后可使用 uv 命令。
-
--format=json❌ 不支持,会报错error: unrecognized option '--format=json' -
--format=csv❌ 同样不支持 - 想导出为 JSON?只能用
uv python list --json(那是列 Python 解释器,不是包)—— 别混淆命令 - 真要机器可读,推荐
uv list --format=freeze | sed 's/==/ /' | awk '{print $1}'提取包名,或用 Python 脚本解析
为什么 uv list 有时看不到刚用 pip 安装的包
因为 uv 和 pip 使用不同的包数据库缓存机制。uv 默认读取的是自己管理的 site-packages 元数据(来自 dist-info 目录里的 INSTALLER 文件),而 pip 直接写入 site-packages 但不一定更新 uv 认可的标记。
典型表现:
- 你在同一环境里先
pip install flask,再uv list却没看到flask - 解决办法:运行
uv pip install --reinstall flask或uv sync(如果有pyproject.toml),强制 uv 重建索引 - 根本原因:uv 的包发现逻辑依赖
INSTALLER文件内容是否为uv,非 uv 安装的包可能被跳过 —— 这不是 bug,是设计取舍
跨工具混用时,尽量统一用 uv 安装,否则列表一致性无法保障。










