跳转至

安装 uv

安装方法

使用我们的独立安装程序或您选择的包管理器来安装 uv。

独立安装程序

uv 提供了一个独立的安装程序来下载和安装 uv：

使用 curl 下载脚本并用 sh 执行：

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

如果您的系统没有 curl，您可以使用 wget：

wget -qO- https://astral.sh/uv/install.sh | sh

通过在 URL 中包含版本号来请求特定版本：

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

使用 irm 下载脚本并用 iex 执行：

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

更改执行策略允许从互联网运行脚本。

通过在 URL 中包含版本号来请求特定版本：

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

Tip

安装脚本可以在使用前进行检查：

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

powershell -c "irm https://astral.sh/uv/install.ps1 | more"

或者，安装程序或二进制文件可以直接从 GitHub 下载。

有关自定义 uv 安装的详细信息，请参阅安装程序的参考文档。

PyPI

为方便起见，uv 已发布到 PyPI。

如果从 PyPI 安装，我们建议将 uv 安装到隔离的环境中，例如，使用 pipx：

pipx install uv

但是，也可以使用 pip：

pip install uv

Note

uv 为许多平台提供了预构建的发行版 (wheels)；如果给定平台没有可用的 wheel，uv 将从源代码构建，这需要 Rust 工具链。有关从源代码构建 uv 的详细信息，请参阅贡献设置指南。

Homebrew

uv 在核心 Homebrew 包中可用。

brew install uv

MacPorts

uv is available via MacPorts.

sudo port install uv

WinGet

uv 可通过 WinGet 获得。

winget install --id=astral-sh.uv  -e

Scoop

uv 可通过 Scoop 获得。

scoop install main/uv

Cargo

uv 可通过 Cargo 获得，但必须从 Git 构建而不是 crates.io，因为它依赖于未发布的 crate。

cargo install --git https://github.com/astral-sh/uv uv

Docker

uv 在 ghcr.io/astral-sh/uv 提供了一个 Docker 镜像。

有关更多详细信息，请参阅我们的在 Docker 中使用 uv 指南。

GitHub Releases

uv 发行版工件可以直接从 GitHub Releases 下载。

每个发行版页面都包含所有支持平台的二进制文件，以及通过 github.com 而不是 astral.sh 使用独立安装程序的说明。

升级 uv

当通过独立安装程序安装 uv 时，它可以按需自行更新：

uv self update

Tip

更新 uv 将重新运行安装程序，并可能修改您的 shell 配置文件。要禁用此行为，请设置 INSTALLER_NO_MODIFY_PATH=1。

当使用其他安装方法时，自更新被禁用。请改用包管理器的升级方法。例如，使用 pip：

pip install --upgrade uv

Shell 自动补全

Tip

您可以运行 echo $SHELL 来帮助您确定您的 shell。

要为 uv 命令启用 shell 自动补全，请运行以下命令之一：

echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc

echo 'uv generate-shell-completion fish | source' > ~/.config/fish/completions/uv.fish

echo 'eval (uv generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv

if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}
Add-Content -Path $PROFILE -Value '(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'

要为 uvx 命令启用 shell 自动补全，请运行以下命令之一：

echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc

echo 'eval "$(uvx --generate-shell-completion zsh)"' >> ~/.zshrc

echo 'uvx --generate-shell-completion fish | source' > ~/.config/fish/completions/uvx.fish

echo 'eval (uvx --generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv

if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}
Add-Content -Path $PROFILE -Value '(& uvx --generate-shell-completion powershell) | Out-String | Invoke-Expression'

然后重新启动 shell 或加载 shell 配置文件。

卸载

如果您需要从系统中删除 uv，请按照以下步骤操作：

  1. 清理存储的数据（可选）：

    uv cache clean
rm -r "$(uv python dir)"
rm -r "$(uv tool dir)"

    Tip

    在删除二进制文件之前，您可能需要删除 uv 存储的任何数据。

  2. 删除 uv 和 uvx 二进制文件：

    rm ~/.local/bin/uv ~/.local/bin/uvx

    rm $HOME\.local\bin\uv.exe
rm $HOME\.local\bin\uvx.exe

    Note

    在 0.5.0 之前，uv 安装在 ~/.cargo/bin 中。可以从那里删除二进制文件以进行卸载。从旧版本升级不会自动从 ~/.cargo/bin 中删除二进制文件。

后续步骤

请参阅第一步或直接跳转到使用指南以开始使用 uv。