本文详细介绍在 linux/macos 系统中安全、完整地卸载通过官方安装脚本（curl + sh）安装的 uv 工具的方法，涵盖缓存清理、数据目录删除及二进制文件移除，并区分不同版本的路径差异。
本文详细介绍在 linux/macos 系统中安全、完整地卸载通过官方安装脚本（curl + sh）安装的 uv 工具的方法，涵盖缓存清理、数据目录删除及二进制文件移除，并区分不同版本的路径差异。
uv 是由 Astral 开发的超高速 Python 包安装与依赖解析工具，其官方推荐安装方式是通过 shell 脚本一键部署：
curl -LsSf https://astral.sh/uv/install.sh | sh
该方式默认将 uv 和 uvx 可执行文件安装至用户本地 bin 目录（如 ~/.cargo/bin/ 或 ~/.local/bin/），并自动配置环境变量。但与 pip install uv 不同，这种安装不经过包管理器注册，因此无法用 pip uninstall 或系统包管理器直接回滚——必须手动清理。
✅ 正确卸载步骤（适用于 uv ≥ 0.5.2）
自 uv v0.5.2（2024 年 11 月发布）起，官方统一了安装路径，默认使用 ~/.local/bin/。卸载需三步协同操作，缺一不可：
- 清空 uv 自身缓存（避免残留下载的 wheel 或构建产物）
- 删除 uv 管理的 Python 解释器目录和工具目录（如 uv python dir 和 uv tool dir 返回的路径）
- 移除主二进制文件
执行以下命令即可完成干净卸载：
立即学习“Python免费学习笔记（深入）”；
# 1. 清理全局缓存 uv cache clean # 2. 删除 uv 托管的 Python 和工具目录（自动解析路径） rm -r "$(uv python dir)" rm -r "$(uv tool dir)" # 3. 删除二进制可执行文件（v0.5.2+ 默认路径） rm ~/.local/bin/uv ~/.local/bin/uvx
⚠️ 注意：请确保 uv 命令当前仍可运行（即 PATH 中仍包含其路径），否则 $(uv python dir) 等子命令将失败。若已提前删除二进制，可跳过第 2 步，改用手动定位目录（通常为 ~/.local/share/uv/python 和 ~/.local/share/uv/tools）。
⚙️ 兼容旧版本（uv
若您安装的是早期版本（如通过 2024 年初或更早的 install.sh 安装），二进制默认位于 ~/.cargo/bin/（因脚本依赖 cargo install 流程）。此时请将最后一步替换为：
# 仅适用于 uv < 0.5.2 rm ~/.cargo/bin/uv ~/.cargo/bin/uvx
您可通过 uv --version 查看当前版本；若命令已不可用，可检查 ls -la ~/.cargo/bin/uv* 或 ls -la ~/.local/bin/uv* 判断安装位置。
? 补充说明与验证
- 卸载后建议检查 PATH 是否仍包含相关目录（如 echo $PATH | grep -E 'cargo|local/bin'），必要时清理 shell 配置文件（如 ~/.bashrc、~/.zshrc）中可能添加的 export PATH="$HOME/.cargo/bin:$PATH" 行。
- pip uninstall uv 仅卸载通过 PyPI 安装的 Python 包版本（通常位于 site-packages），不会影响上述脚本安装的独立二进制，二者完全独立，可共存。
- Windows 用户请参考 官方卸载文档，路径与命令语法略有不同（如使用 PowerShell 删除 %LOCALAPPDATA%\uv\）。
执行完毕后，运行 which uv 应无输出，uv --version 应报“command not found”，即表示卸载成功。整个过程无需 root 权限，全部在用户空间完成，安全可控。
