Python uv虚拟环境管理工具详解

一、安装uv

1.1、Linux/macOS

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

1.2、Windows

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

1.3、使用pip安装

pip install uv

1.4 换源

1.4.1 设置环境变量法

# 设置清华镜像源
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
export UV_EXTRA_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple

# 或者设置阿里云镜像源
export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
export UV_EXTRA_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/

1.4.2 配置文件法

mkdir -p ~/.config/uv

vim ~/.config/uv/uv.toml

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

二、创建新项目

2.1 创建项目

uv init my-project  --python 3.10

2.2 创建虚拟环境

uv venv --python 3.10

或

uv venv

2.3 激活环境

source .venv/bin/activate

2.4 退出环境

deactivate

三、安装依赖

3.1 安装单个包

uv add requests

3.2 安装多个包

uv add pandas numpy matplotlib

3.3 安装特定版本

uv add "django==4.2.0"

3.4 从requirements.txt安装

uv add -r requirements.txt

3.5 安装开发依赖

uv add --dev pytest black flake8

3.6 一键安装pyproject.toml中的依赖

3.6.1 安装 dependencies

uv sync

3.6.2 安装 dev 依赖组

uv sync --group dev

3.6.1 一次性安装所有依赖组

uv sync --all-groups

为什么不全部放在 dependencies？

为了环境分离

[project]
dependencies = [
    "matplotlib>=3.10.7",  # 生产必需
    "numpy>=2.2.6",        # 生产必需
]

[dependency-groups]
dev = [                    # 开发工具
    "black>=25.9.0",
    "pytest>=8.4.2",
]
test = [                   # 测试专用
    "pytest-cov>=5.0.0",
]
docs = [                   # 文档生成
    "sphinx>=7.0.0",
]

四、移除依赖

4.1 移除单个包

uv remove requests

4.2 移除多个包

uv remove pandas numpy

4.3 移除开发依赖

uv remove --dev pytest

五、更新依赖

5.1 更新所有包

uv sync --upgrade

5.2 更新特定包

uv add "requests --upgrade"

六、列出已安装依赖包

6.1 列出所有包

uv tree

6.2 以requirements格式列出

uv pip freeze