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 list
fastapi 0.115.11 pydantic 2.10.6
- 卸载所有包:
或者逐个卸载:uv pip freeze | xargs uv pip uninstall -y
uv 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
是最干净的方式。