使用 uv 管理 Python 虚拟环境指南

为什么选择 uv？

极速体验

    比传统 virtualenv + pip 快 10-100 倍（基于 Rust 开发）

一体化工具

    替代 virtualenv + pip + pip-tools 的工具链

生产就绪

    由创建 Ruff 的团队开发，兼容标准工具链

跨平台支持

    支持 Windows/macOS/Linux 系统

要使用 uv 管理 Python 虚拟环境，请按以下步骤操作：

1. 安装 uv

途径 1.  pip 安装

pip install uv

途径 2. 源码安装（ubantu）

下载页面：https://github.com/astral-sh/uv/releases/tag/0.9.25

ubantu 上下载

curl -L https://github.com/astral-sh/uv/releases/download/0.9.25/uv-x86_64-unknown-linux-gnu.tar.gz -o uv.tar.gz

解压

tar -xzf uv.tar.gz

移动到可执行路径

sudo mv uv-x86_64-unknown-linux-gnu/uv /usr/local/bin/

或者移动到用户目录

mkdir -p ~/.local/bin
mv uv-x86_64-unknown-linux-gnu/uv ~/.local/bin/

确保  ~/.local/bin 在 PATH 中

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

清理

rm -rf uv.tar.gz uv-x86_64-unknown-linux-gnu

途径 3.  脚本安装（ubantu）

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

---

让 uv 下载 Python 3.12.12（它会自动处理）

uv python download 3.12.12

设置 uv 默认 python 版本

uv python default 3.12.12

2. 创建虚拟环境

uv venv .venv  # 创建名为 .venv 的虚拟环境

或自定义名称：

uv venv myenv   # 创建名为 myenv 的虚拟环境

3. 激活虚拟环境

• Windows:

.\.venv\Scripts\activate

• Unix/macOS:

source .venv/bin/activate

4. 在虚拟环境中操作

# 安装包
uv pip install numpy pandas

# 安装 requirements.txt 中的依赖
uv pip install -r requirements.txt

# 运行 Python 脚本
uv run main.py

# 导出依赖
uv pip freeze > requirements.txt

5. 退出虚拟环境

deactivate

常用命令

项目管理

• uv init [project-name] # 初始化新项目
• uv add [package] # 添加包
• uv remove [package] # 移除包
• uv sync # 同步依赖

虚拟环境管理

• uv venv # 创建虚拟环境
• uv venv --python 3.12 # 用指定 Python 版本
• source .venv/bin/activate # 激活环境
• deactivate # 退出环境

Python 版本管理

• uv python list # 列出可用的 Python 版本
• uv python download 3.12.0 # 下载 Python 版本
• uv python register /path/to/python # 注册现有 Python

工具命令

• uv run python script.py # 运行脚本
• uv pip install package # 使用 pip 风格安装
• uv lock # 生成锁文件
• uv tool install [tool] # 安装工具（如 black, ruff）

优势特点

1. 极速：比传统 virtualenv + pip 快 10-100 倍（基于 Rust 开发）
2. 一体化：替代 virtualenv + pip + pip-tools 的工具链
3. 生产就绪：由创建 Ruff 的团队开发，兼容标准工具链
4. 跨平台：支持 Windows/macOS/Linux

注意：如果遇到权限问题，可在命令前添加 python -m 运行（如 python -m uv venv .venv）。建议使用最新版 Python 以获取最佳体验。

格式化美化展示

使用 uv 管理 Python 虚拟环境指南