uv使用教程

发表于 分类于 ， 阅读次数： Disqus： 本文字数： 424 阅读时长 ≈ 2 分钟

uv的安装和使用。

安装 uv

在 macOS 上安装

推荐使用 Homebrew 安装： 

1
2
3
4
# 推荐使用 Homebrew 安装：
brew install uv
# 或者使用官方安装脚本：
curl -LsSf https://astral.sh/uv/install.sh | sh

在 Linux 上安装

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

在 Windows 上安装

1
2
# 使用 Winget：
winget install uv

安装完成后，验证安装是否成功： 

1
uv --version

核心使用场景

Python版本管理

查看可用的 Python 版本： 

1
uv python list

安装特定版本的 Python： 

1
2
3
4
5
6
7
8
# 安装最新的 Python 3.12
uv python install 3.12

# 安装特定版本
uv python install 3.11.6

# 安装 PyPy 版本
uv python install pypy3.10

切换当前Python版本 

1
uv python use 3.10

设置全局默认 Python 版本： 

1
uv python default 3.12

虚拟环境管理

环境创建 

1
2
3
4
5
6
7
8
9
10
11
# 创建名为 .venv 的虚拟环境（默认）
uv venv

# 创建Python 3.12虚拟环境
uv venv --python 3.12 .venv

# 在当前目录下创建一个名为 my-project-env 的虚拟环境，使用指定的 Python 3.11 版本
uv venv -p python3.11 my-project-env

# 在指定路径创建一个名为 custom-env 的虚拟环境，使用 Python 3.10
uv venv -p python3.10 /path/to/my/project/custom-env

激活环境 

1
2
3
4
# Windows (CMD): 
.\venv\Scripts\activate
# macOS/Linux (Bash/Zsh): 
source .venv/bin/activate

使用环境 

1
2
3
4
5
6
7
8
9
10
11
12
# 安装环境专属依赖
uv pip install torch
# 安装全局依赖（--system表示全局安装）
uv pip install numpy --system

# 安装指定版本的 Flask 包
uv pip install Flask==2.2.2
# 从 requirements.txt 文件安装所有依赖
uv pip install -r requirements.txt

# 卸载 requests 包
uv pip uninstall requests

移除虚拟环境 

1
2
3
4
5
# 删除当前目录下的名为 .venv 的虚拟环境
uv venv --remove .venv

# 删除指定路径的虚拟环境
uv venv --remove /path/to/my/project/my-project-env