从零开始掌握极速 Python 包管理器

uv 概述

什么是 uv？

uv 是由 Astral 公司开发的极速 Python 包和项目管理器，使用 Rust 语言编写。它的设计目标是成为一个统一的 Python 工具链，能够替代 pip、pip-tools、pipx、poetry、pyenv、virtualenv 等多个工具。

使用 uv 高效管理 Python 项目的完整指南

项目初始化

创建新项目

uv 提供了多种项目模板，适用于不同场景：

# 创建应用项目（默认）
uv init myapp

# 创建库项目（用于发布到 PyPI）
uv init --lib mylib

# 创建可打包项目
uv init --package mypackage

# 在当前目录初始化
uv init

深入理解 uv 的虚拟环境隔离机制与最佳实践

虚拟环境概述

什么是虚拟环境？

虚拟环境是一个独立的 Python 运行环境，拥有自己的 Python 解释器、包安装目录和配置。它解决了以下问题：

uv 的虚拟环境优势

使用 uv 轻松管理多个 Python 版本

概述

uv 内置了完整的 Python 版本管理功能，可以替代 pyenv、python-build 等工具。它能够自动下载、安装和管理多个 Python 版本。

核心优势

深入理解 uv 的依赖解析机制与锁文件管理

依赖解析基础

什么是依赖解析？

依赖解析是确定项目所需的所有包及其兼容版本的过程。这是包管理器最核心也是最复杂的功能之一。

uv 的依赖解析器

uv 使用高性能的 PubGrub 算法进行依赖解析：

使用 uvx 和 uv tool 管理 Python 命令行工具

uvx 概述

uvx 是 uv 提供的工具运行器，类似于 npx（Node.js）或 pipx run。它允许你无需全局安装即可运行 Python 命令行工具。

核心优势

深度定制 uv 行为与最大化性能

配置系统概述

uv 支持多层次的配置系统，从全局到项目级别：

配置文件

全局配置 (uv.toml)

创建用户级配置文件：

Linux/macOS: ~/.config/uv/uv.toml
Windows: %APPDATA%\uv\uv.toml

# 包索引配置
index-url = "https://pypi.org/simple"
extra-index-url = [
    "https://pypi.tuna.tsinghua.edu.cn/simple",
]

# 网络设置
connect-timeout = 30
read-timeout = 60

# 并发设置
concurrent-downloads = 50
concurrent-builds = 4
concurrent-installs = 8

# 缓存设置
cache-dir = "~/.cache/uv"
# no-cache = false

# Python 设置
python-preference = "managed"
python-downloads = "automatic"

# 链接模式
link-mode = "symlink"

# 输出设置
# no-progress = false
# quiet = false
# verbose = false

团队使用 uv 的最佳实践与从其他工具迁移的完整指南

从 pip 迁移

迁移策略

阶段 1: 直接替换

最简单的迁移，直接用 uv pip 替换 pip：

# 原有命令
pip install flask requests
pip install -r requirements.txt
pip freeze > requirements.txt

# 替换为
uv pip install flask requests
uv pip install -r requirements.txt
uv pip freeze > requirements.txt

全面对比 uv 与 pip、poetry、pdm、conda 等 Python 包管理工具

工具全景图

功能对比总览