uv 使用

astral-sh/uv

安装

macOS

brew install uv

Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

安装命令补全

echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc     # uv 命令补全
echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc  # uvx 命令补全

卸载

# 清理缓存
uv cache clean
rm -r "$(uv python dir)"
rm -r "$(uv tool dir)"
# 删除 uv
rm ~/.local/bin/uv ~/.local/bin/uvx

参考：Installation | uv

使用

管理 uv 项目

使用 uv 不需要显式安装 Python。默认情况下，uv 会在需要时自动下载。

1. 初始化项目：

   uv init -p 3.12  # 创建项目配置文件
   

   • -p：指定 Python 版本

2. 添加依赖：

   uv add requests             # 添加依赖并安装
   uv add requests==2.31.0     # 指定依赖版本
   uv add -r requirements.txt  # 导入依赖
   uv remove requests          # 删除依赖
   

3. 运行：

   uv run main.py  # 运行脚本
   uv run pytest   # 运行模块
   

4. 锁定依赖：

   uv lock     # 进行依赖解析并生成锁文件
   uv lock -U  # 更新依赖到最新兼容版本并生成锁文件
   

5. 同步依赖：

   uv sync  # 使用锁文件同步依赖
   

参考：Projects | uv

管理 pip 项目

1. 创建虚拟环境：

   uv venv -p 3.12
   

2. 安装包：

   uv pip install numpy
   

参考：The pip interface | uv

换源

vim ~/.config/uv/uv.toml

[[index]]
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
default = true

参考：pypi | 清华大学开源软件镜像站

环境变量

export UV_CACHE_DIR="$HOME/.cache/uv"
export UV_PYTHON_INSTALL_DIR="$HOME/.local/share/uv/python"
export UV_PYTHON_BIN_DIR="$HOME/.local/bin"
export UV_TOOL_DIR="$HOME/.local/share/uv/tools"
export UV_TOOL_BIN_DIR="$HOME/.local/bin"

参考：Manage all uv-related directories | GitHub