python uv 使用教程

以下是 uv 的使用教程。uv 是一个由 Astral 开发的超快 Python 包安装工具和解析器，使用 Rust 编写，旨在替代 pip、pip-tools 和 virtualenv，提供更快的性能和更好的依赖管理。

---

1. 安装 uv

可以通过以下任一方式安装 uv：

1.1 使用 pip 安装（推荐）

pip install uv

1.2 直接下载二进制文件

从 GitHub Releases 下载预编译的二进制文件：
https://github.com/astral-sh/uv/releases

---

2. 基本使用

2.1 创建虚拟环境

# 创建一个名为 `venv` 的虚拟环境（默认目录）
uv venv

# 指定虚拟环境名称或路径
uv venv myenv

2.2 激活虚拟环境

• Linux/macOS:

  source myenv/bin/activate
  

• Windows (PowerShell):

  .\myenv\Scripts\activate
  

---

2.3 安装依赖包

# 安装单个包
uv pip install requests

# 安装多个包
uv pip install requests pandas

# 从 requirements.txt 安装
uv pip install -r requirements.txt

2.4 生成 requirements.txt

# 导出当前环境的依赖到 requirements.txt
uv pip freeze > requirements.txt

2.5 升级依赖

# 升级指定包
uv pip install --upgrade requests

# 升级所有包
uv pip install --upgrade -r requirements.txt

2.6 卸载包

uv pip uninstall requests

---

3. 高级用法

3.1 快速初始化项目

# 初始化项目并安装依赖（一步完成）
uv venv && uv pip install -r requirements.txt

3.2 生产环境部署

使用 --system 直接在系统 Python 中安装（不推荐，建议用虚拟环境）：

uv pip install --system -r requirements.txt

3.3 依赖解析与锁定

uv 支持生成精确的依赖锁文件（类似 poetry）：

# 生成锁文件
uv pip compile requirements.in -o requirements.txt

3.4 替代 pip 命令

uv 完全兼容 pip 命令，可以直接替换：

# 例如：
uv pip list
uv pip show requests

---

4. 性能优势

• 极速安装：uv 的安装速度比 pip 快 10-100 倍。
• 并发下载：支持并行下载依赖包。
• 更好的依赖解析：避免 pip 的依赖冲突问题。

---

5. 常见问题

5.1 如何迁移现有项目到 uv？

1. 删除旧的虚拟环境（如 venv）。
2. 使用 uv venv 创建新环境。
3. 运行 uv pip install -r requirements.txt。

5.2 与 pip 的兼容性？

uv 完全兼容 pip 命令和 requirements.txt 格式，无需修改现有配置。

5.3 支持哪些操作系统？

• Linux
• macOS
• Windows (需 PowerShell)

---

6. 官方资源

• GitHub 仓库：https://github.com/astral-sh/uv
• 文档：https://uv.astral.sh

---

通过 uv，你可以显著提升 Python 依赖管理的效率。尝试用它替代传统的 pip 和 virtualenv，体验更快的开发流程！