uv pip list可查看当前激活虚拟环境中安装的包;uv tool list用于列出uv tool install安装的cli工具;检查未激活环境需用--python指定解释器路径或读取dist-info目录。

在使用 Python 的 uv 包管理器时,快速确认当前环境中已安装哪些第三方包,是日常开发和环境排查的高频需求。uv 本身不维护传统 pip 的 site-packages 目录式全局视图,其行为严格绑定于目标环境(venv 或 system),直接运行命令却未指定环境,可能返回空结果或报错。
查看当前激活虚拟环境中的已安装包
确保终端中已激活目标 uv 创建的虚拟环境(例如通过 source .venv/bin/activate 或 Windows 的 .venv\Scripts\activate),再执行:
uv pip list
这一步会列出所有通过 uv pip install 安装到该环境中的包及其版本号。若提示 “No such file or directory: 'pip'”,说明 uv 未内置 pip 兼容层——此时需先运行 uv pip compile --upgrade 初始化 pip 支持,或改用更底层的 uv 命令。
用 uv tool list 查看通过 uv tool install 安装的可执行工具包
uv tool install 安装的是带 CLI 的工具型包(如 ruff、maturin),它们不进入 Python 导入路径,而是放在 uv 的工具存储目录中:
uv tool list
该命令只显示通过 uv tool install 安装的工具包,不包含普通库包。它默认读取当前用户的 uv 工具目录(~/.local/share/uv/tools),无需激活环境。
查看特定环境(非当前激活)中的包列表
当需要检查一个未激活的 uv 虚拟环境(如 myenv)时,不能依赖 uv pip list,因为该命令默认作用于当前 Python 解释器。必须显式指定环境路径:
方法一:使用 --python 指向环境内 Python 解释器
uv pip list --python ./myenv/bin/python
方法二:使用 --system-site-packages(仅限创建时启用了该选项的环境)
uv pip list --system-site-packages
方法三:直接读取环境 site-packages 中的 dist-info 目录(适用于调试)
ls ./myenv/lib/python3.*/site-packages/*-*.dist-info | xargs -n1 basename | sed 's/-.*$//' | sort -u
【注意:此 shell 方式不识别可选依赖、不显示版本号、且在 Windows 上不可用】
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











