uv,一个由 Astral 开发的现代 Python 包管理和项目工具(类似于 pip 的替代品,但更快、更高效)。它与传统的 pip 在用法上有相似之处,但也有一些不同。如果想清理 uv 和它管理的依赖,方法会略有调整。下面详细说明如何清理 uv pip 及其所有依赖。
情况 1:清理虚拟环境中 uv 管理的依赖
假设你在项目中用 uv 创建了一个虚拟环境(默认在 .venv 文件夹):
步骤 1:进入项目目录并激活环境
cd /Users/mac/workspace/project/ai/OpenManus
source .venv/bin/activate
如果 uv 创建的环境不在 .venv,可以用 uv venv --seed 检查或重新创建。
步骤 2:列出并删除所有依赖
- 查看已安装的包:
输出示例:uv pip listfastapi 0.115.11 pydantic 2.10.6 - 卸载所有包:
或者逐个卸载:uv pip freeze | xargs uv pip uninstall -yuv pip uninstall fastapi -y uv pip uninstall pydantic -y # 依次卸载其他包
步骤 3:清理 uv 的缓存
uv 会缓存下载的包,可以清理:
uv cache clean
这会删除 uv 的全局缓存(默认位于 ~/Library/Caches/uv)。
步骤 4:删除虚拟环境
如果想彻底清理,直接删除虚拟环境:
deactivate
rm -rf .venv
然后重建:
uv venv
source .venv/bin/activate
步骤 5:验证
uv pip list
只应显示基本的 pip 和 setuptools。
情况 2:清理全局环境中 uv 管理的依赖
如果你在全局环境下用 uv pip 安装了包(不推荐,但可能发生):
步骤 1:确认全局环境
uv pip list --system
这会显示全局安装的包。
步骤 2:卸载所有全局依赖
uv pip freeze --system | xargs uv pip uninstall -y --system
需要 sudo 权限时:
sudo uv pip freeze --system | xargs uv pip uninstall -y --system
步骤 3:卸载 uv 本身(可选)
如果你想清理 uv 工具本身:
- 如果通过
pip安装:pip uninstall uv -y - 如果通过 Homebrew 安装:
brew uninstall uv
步骤 4:清理缓存
uv cache clean
情况 3:清理 uv 和 pip 共存的环境
如果你的环境中同时用了 pip 和 uv pip 安装依赖,清理时需要分别处理:
- 用
pip list和uv pip list检查两者的包。 - 分别卸载:
pip freeze | xargs pip uninstall -y uv pip freeze | xargs uv pip uninstall -y - 清理缓存:
pip cache purge uv cache clean
示例:清理虚拟环境中的 uv pip 依赖
# 进入项目目录
cd /Users/mac/workspace/project/ai/OpenManus
# 激活环境
source .venv/bin/activate
# 删除所有依赖
uv pip freeze | xargs uv pip uninstall -y
# 清理缓存
uv cache clean
# 检查
uv pip list
# 如果需要重建
deactivate
rm -rf .venv
uv venv
source .venv/bin/activate
与传统 pip 的区别
- 命令:
uv pip <subcommand>是uv的子命令,模仿pip的接口,例如uv pip install、uv pip uninstall。 - 缓存:
uv的缓存独立于pip,用uv cache clean清理。 - 虚拟环境:
uv venv创建的环境默认在.venv,而pip的venv通常自定义路径。
注意事项
- 确认工具:运行
which uv和which pip确认使用的是哪个工具。 - 项目文件:如果用
uv管理依赖,可能有pyproject.toml,可以用uv sync同步或清理。 - 彻底重置:删除
.venv或全局site-packages是最干净的方式。
