uv - 基本使用

---

安装 uv

pip install uv

---

空文件夹中创建 UV 环境

创建虚拟环境并激活

# 创建虚拟环境（默认在 .venv 目录）
uv venv# 激活环境（Linux/macOS）
source .venv/bin/activate# 激活环境（Windows）
.\.venv\Scripts\activate

• uv venv不会独立安装 Python，而是直接继承当前激活的 Python 解释器版本

---

安装包

# 直接安装包（如 numpy）
uv pip install numpy# 安装指定版本
uv pip install numpy==1.24.0# 或从 requirements.txt 安装（即使文件不存在，后续可以生成）
uv pip install -r requirements.txt

---

已有代码和 requirements.txt 时管理环境

初始化环境

# 创建虚拟环境
uv venv# 激活环境（同上）
source .venv/bin/activate # 安装现有依赖（类似 pip install -r requirements.txt）
uv pip install -r requirements.txt

---

依赖管理

# 添加新依赖（自动更新 requirements.txt）
uv pip install requests && uv pip freeze > requirements.txt# 生成精确的依赖版本（类似 pip-tools）
uv pip compile requirements.in -o requirements.txt# 升级所有依赖
uv pip install --upgrade -r requirements.txt

---

其他常用操作

# 快速锁定依赖版本（替代 pip-compile）
uv pip compile# 同步环境（确保与 requirements.txt 完全一致）
uv pip sync requirements.txt# 卸载包
uv pip uninstall package_name

---