如何使用 Astral UV 管理 Python 虚拟环境？

Astral UV 是一款由 Astral 公司（以开发高性能 Python 工具 Ruff 闻名）推出的 超高速 Python 包管理和项目管理工具，完全用 Rust 编写。它旨在取代传统的 Python 工具链（如 pip、virtualenv、poetry、pyenv 等），提供更快的速度和更统一的工作流。在 Astral UV 的上下文中，象征工具的高速性（Ultra-Velocity）和多功能性（Universal）。本文主要讲述如何在 Linux 下安装 Astral UV。

如何安装 UV

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

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 或通过 pip
pip install uv

这里只列举了三种常用的安装方式，更多安装方式可以参考 Astral UV 的官方文档installing-uv

创建 python 虚拟环境

uv venv --python 3.12 --seed

解释：
venv：UV 的子命令，用于创建一个新的虚拟环境。类似于 Python 的内置模块 venv 或 virtualenv，它会在指定目录中创建一个隔离的 Python 环境。
–python 3.12: 指定虚拟环境使用的 python 版本
–seed: 表示在创建虚拟环境后，预先安装一些基础工具，如：pip, setuptools, wheel。这个选项确保虚拟环境在创建后立即可用，而无需手动安装这些工具。
注意事项：
如果未指定路径（如 myenv）, Astral UV 可能会在当前目录下创建默认的虚拟环境。

如何激活 python 虚拟环境

# for RHEL
source .venv/bin/activate

# 修改环境变量
cat <<EOF >> $HOME/.bashrc
source "$HOME/.venv/bin/activate"
EOF

uv 取消激活虚拟环境

deactivate

自动更新

当通过独立安装程序安装 uv 时，它可以根据需要自行更新：

uv self update

如何卸载 UV

如果您需要从系统中删除 uv，请按照以下步骤操作：

1. 清理存储的数据（可选）：

uv cache clean
rm -r "$(uv python dir)"
rm -r "$(uv tool dir)"

2. 删除 uv 和 uvx 二进制文件：

# for linux/macos
rm ~/.local/bin/uv ~/.local/bin/uvx

# for Windows
rm $HOME\.local\bin\uv.exe
rm $HOME\.local\bin\uvx.exe

参考文档

Astral uv 官网

Astra uv 安装文档