uv 是 Astral 团队推出的极速 Python 包管理器,旨在替代 pip 和 poetry 等现有工具。它不仅能加速依赖解析,还能统一管理虚拟环境。下面我们来聊聊如何在本地环境中快速上手。
安装
最简单的方式是通过 pip 直接安装,适合大多数场景:
pip install uv
如果你更倾向于官方推荐的一键脚本,也可以访问文档页面获取对应平台的安装命令。
检查安装
安装完成后,运行以下命令确认版本信息,确保一切正常:
uv --version
如果终端输出了类似 uv 0.6.3 的版本号,说明安装成功。
升级
uv 支持自我更新,这是最推荐的方式,它会重新运行安装程序并可能修改你的 shell 配置文件:
uv self update
如果遇到权限问题或不想自动修改配置,可以设置环境变量 INSTALLER_NO_MODIFY_PATH=1 来禁用此行为。
当然,你也可以继续使用 pip 进行升级:
pip install --upgrade uv
设置自动补全
为了提升命令行体验,建议配置 Shell 自动补全。根据你的 Shell 类型执行对应的命令:
Bash:
eval "$(uv generate-shell-completion bash)" >> ~/.bashrc
Zsh:
eval "$(uv generate-shell-completion zsh)" >> ~/.zshrc
记得重启终端或执行 source ~/.bashrc 使配置生效。
卸载
彻底卸载 uv 需要两步走:清理缓存数据和删除二进制文件。
1. 清理存储数据(可选) 这一步会清除项目缓存和已安装的 Python 版本,请谨慎操作:
uv cache clean
rm -r "$(uv python dir)"
rm -r "$(uv tool dir)"
2. 删除二进制文件 根据操作系统不同,路径有所区别:
macOS 和 Linux:
rm ~/.local/bin/uv ~/.local/bin/uvx
Windows: 建议使用 PowerShell 或 CMD 删除,路径通常在用户目录下:
Remove-Item "$env:USERPROFILE\.local\bin\uv.exe"
Remove-Item "$env:USERPROFILE\.local\bin\uvx.exe"
注意:在 0.5.0 版本之前,uv 可能被安装到了 ,如果是这种情况,也请从该目录移除相关文件。升级到旧版本不会自动删除二进制文件,需手动处理。


