安装 Python

如果系统中已安装 Python，uv 会自动检测并使用，无需额外配置。不过，uv 也能够安装和管理 Python 版本。uv 会根据需要自动安装缺失的 Python 版本，因此你无需预先安装 Python 即可上手。

开始使用

安装最新版本的 Python：

$ uv python install

注意

Python 官方并未发布可分发的二进制文件。因此，uv 使用的是 Astral 的python-build-standalone 项目提供的发行版。更多详细信息，请参阅Python 发行版文档。

Python 安装完成后，uv 命令将自动使用它。

重要

uv 安装的 Python 不会全局可用（即无法通过 python 命令调用）。此功能目前处于预览阶段。详细信息请参阅安装 Python 可执行文件。

你仍然可以使用uv run 或创建并激活虚拟环境来直接使用 python。

安装特定版本的 Python：

$ uv python install 3.12

安装多个 Python 版本：

$ uv python install 3.11 3.12

安装其他 Python 实现，例如 PyPy：

$ uv python install pypy@3.10

更多详细信息，请参阅python install文档。

要重新安装由 uv 管理的 Python 版本，请使用 --reinstall，例如：

$ uv python install --reinstall

这将重新安装所有之前安装的 Python 版本。Python 发行版不断有改进，因此即使 Python 版本未改变，重新安装也可能解决一些问题。

要查看可用和已安装的 Python 版本：

$ uv python list

更多详细信息，请参阅 python list 文档。

使用 uv 无需显式安装 Python。默认情况下，uv 会在需要时自动下载 Python 版本。例如，如果尚未安装 Python 3.12，以下命令将下载它：

$ uvx python@3.12 -c "print('hello world')"

即使未请求特定的 Python 版本，uv 也会按需下载最新版本。例如，如果系统上没有任何 Python 版本，以下命令将在创建新的虚拟环境之前安装 Python：

$ uv venv

Tip

如果你希望对 Python 的下载时间有更多控制权，可以轻松禁用自动下载 Python。

如果系统上已安装 Python，uv 会使用这些现有安装。此行为无需配置：如果系统 Python 满足命令调用的要求，uv 就会使用它。有关详细信息，请参阅Python 查找文档。

若要强制 uv 使用系统 Python，请提供 --no-managed-python 标志。有关更多详细信息，请参阅Python 版本偏好设置文档。

要详细了解 uv python，请参阅Python 版本概念页面和命令参考。

或者，继续阅读以了解如何使用 uv 运行脚本和调用 Python。