uv：高性能 Python 包和项目管理工具使用教程

前言

在 Python 开发中，包管理和项目管理是日常工作中至关重要的部分。传统工具如 pip、poetry 等在功能上各有特点，但在性能和易用性方面可能存在一些局限。近期，uv 作为一款全新的工具引起了广泛关注。它由 Astral 团队开发，旨在提供更高效、更灵活的包管理和项目管理体验。本文将深入介绍 uv 的功能，并通过实例演示其使用方法。

---

什么是 uv？

uv 是一款用 Rust 编写的超高速 Python 包和项目管理工具。它的设计目标是替代现有的包管理工具，如 pip、pip-tools、poetry 等，同时提供更高的性能和更丰富的功能。与传统工具相比，uv 在以下方面表现尤为突出：

• 高性能：在许多操作中，uv 的速度比传统工具快上10到100倍。
• 项目管理：提供类似于 poetry 的项目管理功能，包括依赖管理、环境隔离等。
• 工具集成：支持与其他工具的集成，如 Jupyter、Docker 等，提升开发体验。

安装 uv

在开始使用 uv 之前，需要先进行安装。以下是在不同操作系统上的安装方法：

macOS 和 Linux

打开终端，执行以下命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

在 PowerShell 中执行以下命令：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装完成后，可以通过以下命令验证安装是否成功：

uv --version

如果显示了 uv 的版本信息，说明安装成功。

uv 的核心功能

uv 提供了多种功能，旨在简化 Python 开发过程。以下是一些核心功能的介绍：

1. Python 版本管理

uv 允许用户管理多个 Python 版本，并在项目之间进行切换。以下是一些常用操作：

列出可用的 Python 版本

查看系统中可用的 Python 版本：

uv python list

安装特定版本的 Python

例如，安装 Python 3.11：

uv python install 3.11

切换 Python 版本

将项目的 Python 版本锁定为 3.11：

uv python pin 3.11

这将在项目根目录下创建一个 .python-version 文件，记录当前使用的 Python 版本。

2. 创建新项目

uv 提供了简便的方式来初始化新的 Python 项目。

初始化项目

在终端中执行以下命令，初始化一个名为 example 的项目：

uv init example

这将在当前目录下创建一个名为 example 的项目文件夹，并生成必要的配置文件。

项目结构

创建项目后，项目目录结构如下：

3. 管理项目依赖

uv 提供了简洁的命令来管理项目的依赖关系。

添加依赖

例如，添加 requests 库作为项目依赖：

uv add requests

锁定依赖

锁定当前的依赖版本，生成 uv.lock 文件：

uv lock

这将确保在不同环境中安装的一致性。

4. 运行项目

在项目环境中运行 Python 脚本：

uv run script.py

这将自动激活项目的虚拟环境，并执行指定的脚本。

总结

uv 作为一款新兴的 Python 包和项目管理工具，以其卓越的性能和丰富的功能，为开发者提供了全新的体验。无论是 Python 版本管理、项目创建、依赖管理还是项目运行，uv 都能有效地简化开发流程，提高工作效率。建议开发者根据自身需求，尝试并深入了解 uv，以便在日常开发中充分发挥其优势。

参考资料：

• 官方文档
• GitHub 仓库