安装UV(一个python工具)
确认系统要求
- macOS:建议更新到最新版本
- Python:3.7 或更高版本(推荐 Python 3.8+)
- Rust 工具链:UV 是用 Rust 编写的,但通常不需要手动安装
安装 UV
方法 1:使用 pip 安装(推荐)
运行以下命令:
pip install uv
注意:如果系统有多个 Python 版本,请使用 pip3
或 python3 -m pip install uv
。
方法 2:使用 Homebrew 安装
如果使用 Homebrew,可以运行:
brew install uv
方法 3:从源码安装(适用于开发者)
git clone https://github.com/astral-sh/uv.git
cd uv
pip install maturin
maturin develop --release
验证安装
运行以下命令检查是否安装成功:
uv --version
如果成功,会显示版本号,例如:
uv 0.1.0
基本使用
UV 可以替代 pip
和 pip-tools
,常用命令:
# 安装包(替代 pip install)
uv pip install numpy# 生成并安装依赖(类似 pip-compile + pip install)
uv pip compile requirements.in -o requirements.txt
uv pip sync requirements.txt# 创建虚拟环境
uv venv .venv
source .venv/bin/activate
常见问题
Q1: uv: command not found
可能 UV 没有被添加到 PATH
,尝试:
export PATH="$HOME/.local/bin:$PATH" # 如果是 pip --user 安装
或者重新登录终端。
Q2: 权限问题
如果遇到权限错误,可以:
pip install --user uv # 用户级别安装
或使用虚拟环境:
python -m venv myenv
source myenv/bin/activate
pip install uv
Q3: 与其他工具冲突
如果已安装 pip-tools
或 pipx
,UV 可以无缝替代它们,但建议先测试兼容性。
卸载 UV
如果想卸载:
pip uninstall uv
或(如果通过 Homebrew 安装):
brew uninstall uv
总结
UV 是一个高性能的 Python 包管理工具,安装方式与普通 Python 包相同,推荐使用 pip install uv
或 brew install uv
。安装后可以替代 pip
进行更快的依赖管理。如果有其他问题,可以查阅 UV 官方文档。 🚀