Python包管理工具之UV

至此流年莫相忘2026-01-17 9:21

官网

什么是 uv？

uv 是由 Astral 团队（也是 Ruff 的作者）开发的一款 超快的 Python 包安装器和解析器 。它用 Rust 编写，目标是 替代 pip、pip-tools、virtualenv、poetry 等工具的部分功能 ，同时速度提升 10~100 倍！

Linux / macOS

bash 复制代码

# 指定下载路径
export UV_INSTALL_DIR="$HOME/.local/bin-custom"
# 下载
curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

bash 复制代码

# 指定下载路径
$env:UV_INSTALL_DIR = "D:\Environment\uv"
# 下载
irm https://astral.sh/uv/install.ps1 | iex

Windows (CMD)

bash 复制代码

# 指定下载路径
set UV_INSTALL_DIR=D:\Environment\uv
# 下载
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

bash 复制代码

pip install uv

⚠️ 注意：通过 pip 安装的 uv 可能不是最新版，且启动稍慢。建议用方法 1。

bash 复制代码

uv --version

uv 默认使用系统缓存（如 ~/.cache/uv），通常无需修改。

Linux/macOS

shell 复制代码

rm ~/.local/bin/uv ~/.local/bin/uvx

Windows(Power Shell)

powershell 复制代码

rm $HOME\.local\bin\uv.exe
rm $HOME\.local\bin\uvx.exe
rm $HOME\.local\bin\uvw.exe

通过 UV 创建虚拟环境

bash 复制代码

mkdir test-uv-project
cd test-uv-project
uv venv

bash 复制代码

# 1. 创建虚拟环境
uv venv
# 激活环境
.venv\Scripts\activate
# 2. 同步依赖
uv sync

uv venv <虚拟环境名称>：创建虚拟环境可以指定虚拟环境名称，如果不指定则默认建在 .venv 目录下，建议不指定。

在 pyproject.toml 添加依赖，会提示安装软件包，直接安装即可：

会将依赖版本添加到uv.lock文件中，并下载软件包

依赖是在 pyproject.toml 添加依赖，然后执行：

bash 复制代码

# 将依赖版本锁定到uv.lock文件
uv lock
# 同步依赖
uv sync

自此，本文分享到此结束！！！