安装Python

如果系统已安装Python，uv将自动检测并使用而无需配置。不过，uv也能安装和管理Python版本。uv会自动安装缺失的Python版本——您无需预先安装Python即可开始使用。

入门指南

安装最新版本的Python：

$ uv python install

注意

Python官方不发布可分发二进制文件。因此，uv使用Astralpython-build-standalone项目提供的发行版。更多详情请参阅Python发行版文档。

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

重要

当Python通过uv安装时，它将不会全局可用（即无法通过python命令调用）。此功能目前处于预览状态。详情请参阅Installing Python executables。

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

要安装特定的Python版本：

$ uv python install 3.12

安装多个Python版本：

$ uv python install 3.11 3.12

要安装替代的Python实现，例如PyPy：

$ uv python install [email protected]

查看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 [email protected] -c "print('hello world')"

即使没有明确要求特定的Python版本，uv也会按需下载最新版本。例如，如果您的系统上没有安装任何Python版本，以下操作将在创建新虚拟环境前自动安装Python：

$ uv venv

提示

如果您希望更好地控制Python下载的时机，可以轻松禁用自动下载Python功能。

如果系统中已存在Python安装，uv将直接使用现有版本。此行为无需额外配置：只要系统Python满足命令调用的要求，uv就会自动使用它。详情请参阅Python发现文档。

要强制uv使用系统Python，请提供--no-managed-python标志。更多详情请参阅 Python版本偏好文档。

要了解更多关于uv python的信息，请参阅Python版本概念页面和命令参考。

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