Python 包管理工具uv常用场景使用指南

bash 复制代码

uv python list

输出示例：

text 复制代码

Installed Python versions:
- 3.11.5 (default)
- 3.12.0

bash 复制代码

uv python install 3.12.0  # 安装 Python 3.12.0

bash 复制代码

uv python pin 3.12.0  # 将当前项目锁定到 Python 3.12.0

bash 复制代码

uv venv --python 3.12.0  # 创建名为 .venv 的虚拟环境，使用 Python 3.12.0

bash 复制代码

# Linux/macOS
source .venv/bin/activate

# Windows
.venv\Scripts\activate

uv 推荐直接使用 uv run 命令运行脚本，无需手动激活环境 ：
bash 复制代码
```
uv run script.py  # 自动激活虚拟环境并执行脚本
```

在项目根目录运行以下命令，根据 pyproject.toml 或 requirements.txt 安装依赖：

bash 复制代码

uv sync  # 安装所有依赖并生成/更新 uv.lock 文件

按分组安装依赖 ：

bash 复制代码

uv sync --only prod    # 仅安装生产依赖
uv sync --only dev     # 仅安装开发依赖

bash 复制代码

uv add requests==2.31.0      # 添加生产依赖
uv add --group dev pytest    # 添加开发依赖
uv sync                      # 更新依赖并生成锁定文件

初始化项目 A

bash 复制代码

cd project_a
uv python pin 3.11.5    # 锁定 Python 版本
uv venv                 # 创建虚拟环境
uv add numpy            # 添加依赖
uv sync

初始化项目 B

bash 复制代码

cd project_b
uv python pin 3.12.0    # 锁定 Python 版本
uv venv
uv add pandas
uv sync

运行脚本

bash 复制代码

cd project_a
uv run main.py  # 使用 Python 3.11 和 project_a 的依赖

cd ../project_b
uv run main.py  # 使用 Python 3.12 和 project_b 的依赖

通过上述操作，uv 可实现从 Python 版本管理到依赖同步的全流程高效控制。