彻底清除uv需四步:一、用rm -f "$(which uv)"删除二进制;二、依次执行rm -rf "$(uv pythondir) 2>/dev/null"、rm -rf "$(uv tooldir) 2>/dev/null"和uv cache clean清理专属数据;三、从~/.bashrc或~/.zshrc中移除补全配置并source生效;四、验证uv --version等命令均返回“command not found”。

在Ubuntu系统中彻底清除uv工具,必须同时删除二进制文件、缓存数据和配置目录,否则残留的uv pythondir或tooldir会干扰后续Python环境管理,甚至导致新安装的uv无法正常识别已安装的Python版本。
确认uv安装位置并删除主程序
执行which uv查看uv二进制路径,常见位置为~/.local/bin/uv或~/.cargo/bin/uv;若返回为空,说明未通过curl/wget/sh脚本安装,跳过此步。
运行rm -f "$(which uv)"直接删除可执行文件;【注意:不要用rm -f ~/bin/uv等模糊路径,必须用$(which uv)确保删对】
清理uv专属数据目录
uv将Python下载目录、虚拟环境缓存、工具安装路径全部隔离存放,需逐个清除:
第一步:清空Python版本缓存目录
执行rm -rf "$(uv pythondir) 2>/dev/null"——该命令会静默忽略不存在的目录,避免报错中断流程。
第二步:删除工具安装根目录
运行rm -rf "$(uv tooldir) 2>/dev/null"——这里存放pipx风格安装的uvx工具,不清理会导致下次重装uv后仍能调用旧版uvx。
第三步:清除通用缓存
执行uv cache clean——这会安全清空wheel构建缓存、HTTP响应缓存等,不加此步可能让新uv误用旧编译产物。
移除shell自动补全配置
方法一:检查是否启用过bash补全
运行grep "uv generate-shell-completion" ~/.bashrc,若输出非空,则执行sed -i '/uv generate-shell-completion/d' ~/.bashrc删除对应行。
方法二:zsh用户请检查~/.zshrc并手动删掉eval "$(uv generate-shell-completion zsh)"这一行。
修改完配置文件后,立即执行source ~/.bashrc(或source ~/.zshrc)使变更生效。
验证卸载是否干净
依次执行以下三条命令,每条都应返回“command not found”或空输出:
uv --version
which uv
ls -d ~/.cache/uv 2>/dev/null










