当前位置：首页 > news >正文

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

news 2025/10/27 11:34:54

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",
]