uv 默认缓存位于 ~/.cache/uv,可通过 rm -rf ~/.cache/uv 彻底清理;建议先用 du -sh ~/.cache/uv 查看大小,再按需删除 wheels、built-wheels 或 archive 子目录,并可设置 uv_cache_dir 环境变量限制缓存路径与规模。

确认 uv 是否已安装并检查缓存位置
uv 是由 Astral 开发的超快 Python 包安装器和解析器,替代 pip 和 virtualenv。它默认将下载的 wheel 缓存存放在 ~/.cache/uv 目录下,该目录随使用时间增长可能占用数百 MB 甚至数 GB 空间。运行 uv --version 确认已安装;若报错,请先通过 curl -LsSf https://astral.sh/uv/install.sh | sh 安装。
直接清空 uv 全局缓存目录
这一步会立即释放所有 uv 下载过的 wheel、built packages 和 resolved index 数据。
执行:rm -rf ~/.cache/uv
⚠️ 注意:【此操作不可逆,且会强制 uv 下次安装包时重新下载 wheel】。如果你近期频繁安装相同包(如 pytest、requests),建议先用下一步查看缓存大小再决定是否清理。
查看 uv 缓存占用空间再清理
避免误删或盲目执行,先量化影响:
第一步:进入缓存根目录 → cd ~/.cache/uv
第二步:统计总大小 → du -sh .
第三步:列出前 5 个最大子目录(常为不同 Python 版本或 index 源的缓存)→ du -sh */ | sort -hr | head -5
如果输出显示 1.2G . 或类似值,说明值得清理;若仅几 MB,可跳过。
按需清理特定缓存类型(高级)
uv 缓存结构分三类:wheels(wheels/)、built packages(built-wheels/)、resolved indexes(archive/)。可单独清理某类:
方法一:只清 wheel 缓存(保留构建结果和索引)→ rm -rf ~/.cache/uv/wheels
方法二:只清构建产物(适合反复构建同一源码包时)→ rm -rf ~/.cache/uv/built-wheels
方法三:只清 index 缓存(解决因 PyPI 镜像变更导致解析失败)→ rm -rf ~/.cache/uv/archive
这三类目录互不依赖,可安全独立删除。删除后 uv 会在下次对应操作中自动重建。
设置 uv 使用更小的缓存策略(预防性)
避免缓存再次膨胀,可通过环境变量限制行为:
在 ~/.bashrc 或 ~/.zshrc 中追加:export UV_CACHE_DIR="$HOME/.cache/uv-limited"export UV_INDEX_URL="https://pypi.org/simple"
然后运行 source ~/.bashrc(或 source ~/.zshrc)生效。新缓存将写入独立路径,便于后续隔离管理或定期 rm -rf ~/cache/uv-limited。











