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 可能被安装到了 ，如果是这种情况，也请从该目录移除相关文件。升级到旧版本不会自动删除二进制文件，需手动处理。
