比 Pip、Poetry 和 Virtualenv 快 100 倍。

uv，是Astral公司开发的革命性工具，它重写了 Python 包安装和虚拟环境设置的规则。uv使用 Rust 开发，不仅仅是另一个包管理工具。它是一个全面的解决方案，能够以前所未有的速度和轻松性处理虚拟环境、依赖关系解析和包管理。

从创建环境到解决复杂的依赖关系，uv 都能做到，而且速度比您以前见过的更快。 uv 取代了 pip、pip-tools、pipz、poetry、pyenv、twine、virtualenv 等，与最常见的 Python 包安装程序 pip 相比，性能提高了 10-100 倍。

安装

uv 可以使用 Astral 的独立安装程序进行安装：

# MacOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

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

也可以通过pip安装

pip install uv

或者，如果使用 MacOS，安装 uv 最简单的方法是使用brew：

brew install uv

设置新项目

要设置新项目，您可以使用以下命令：

uv init <APP_NAME> --app

# you can also run the following the create a Python library or package
uv init <LIB_NAME> --lib
uv init <PACKAGE_NAME> --package

注意：默认参数是“ --app ”，因此不需要明确说明。

初始化项目后，将创建以下文件/目录：

1. .git ：本地 git 设置，稍后您可以将其附加到远程
2. .gitignore ：要从 git 存储库中排除的与 Python 相关的文件扩展名和文件夹
3. .python-version ：说明为虚拟环境选择的 Python 版本的文件
4. hello.py ：占位符Python文件
5. pyproject.toml ：包含所有项目配置详细信息的文件
6. README.md ：空 Markdown 文档文件

下一步是运行以下命令：

cd <APP_NAME>

uv run hello.py

通过这样做，uv 将创建一个虚拟环境（ .venv ），并安装pyproject.toml文件中声明的所有依赖项（创建uv.lock文件），并执行hello.py文件。

添加和删?除依赖项

与 pip 相比，使用 uv 添加和删除依赖项非常简单且快速。

要添加新的依赖项，请运行以下命令：

uv add pandas

要删除依赖项，请运行以下命令：

uv remove pandas

注意：可以通过命令行逐个声明来添加或删除多个依赖项。

如果您发现本地依赖项未与虚拟环境同步，您可以运行以下命令将它们同步：

uv sync

升级依赖版本

您可以通过多种方式声明您想要在虚拟环境中使用的依赖项版本。

首先，您可以手动修改pyproject.toml文件中的版本号，也可以运行以下命令：

# upgrade a specific package
uv lock --upgrade-package pandas

# upgrade multiple packages
uv lock --upgrade-package numpy scipy matplotlib

# upgrade all dependencies
uv lock --upgrade

# dry run to see potential upgrades without applying
uv lock --upgrade --dry-run

注意：在将软件包升级应用于生产之前，请务必检查它们以确保兼容性。

查看依赖树

uv 使用户能够查看依赖关系树，这可以通过运行以下命令来显示：

uv tree

此命令提供项目依赖关系层次结构的全面可视化表示，显示：

• 所有已安装的软件包
• 嵌套依赖项
• 版本信息
• 包之间的关系

Python 版本控制

许多开发人员都在 uv 中遇到的一个重要功能是了解他们的系统上有哪些 Python 版本。

uv 将首先通过 uv 检查 Python 安装，然后通过系统路径检查。如果这些都没有返回 Python 安装，uv 将安装第一个可用的兼容 Python 版本。

要检查所有可用的 Python 版本，请运行以下命令：

uv python list

该命令显示：

• 已安装的可用 Python 版本
• 各自的安装路径
• uv 和系统路径检测到的版本

如果要安装当前不可用的特定版本的Python，可以运行以下命令：

# install a specific Python version
uv python install 3.12.0

# install within a version range
uv python install '>=3.8,<3.10'

结论

UV 使 Python 开发更快、更简单。只需几个命令，您就可以设置项目、管理依赖项并处理虚拟环境 - 比 pip 和 Poetry 等传统工具快 100 倍。

如果您厌倦了缓慢的安装和复杂的工作流程，UV 就是解决方案。立即尝试，看看它如何改变您的 Python 项目！