安装 uv

安装方法

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

独立安装程序

uv 提供了独立安装程序用于下载和安装：

macOS 和 LinuxWindows

使用 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.7.4/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.7.4/install.ps1 | iex"

Tip

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

macOS 和 LinuxWindows

$ 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

注意

uv 为多个平台提供了预编译的发行版（wheel 包）；如果某个平台没有对应的 wheel 包，uv 会从源码构建，这需要 Rust 工具链。关于从源码构建 uv 的详细说明，请参阅贡献指南中的设置部分。

Cargo

uv 可通过 Cargo 安装，但由于依赖未发布的 crate，必须从 Git 仓库构建而非 crates.io。

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

Homebrew

uv 已纳入 Homebrew 核心包库。

$ brew install uv

WinGet

uv 可通过 WinGet 安装。

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

Scoop

uv 可通过 Scoop 安装。

$ scoop install main/uv

Docker

uv 提供了 Docker 镜像，地址为 ghcr.io/astral-sh/uv。

更多细节请参阅我们在 Docker 中使用 uv 的指南。

GitHub Releases

uv 的发布文件可直接从 GitHub Releases 下载。

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

升级 uv

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

$ uv self update

提示

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

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

$ pip install --upgrade uv

Shell 自动补全

Tip

你可以运行 echo $SHELL 来确定当前使用的 shell。

要为 uv 命令启用 shell 自动补全，运行以下对应命令：

BashZshfishElvishPowerShell / pwsh

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 自动补全，运行以下对应命令：

BashZshfishElvishPowerShell / pwsh

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 二进制文件：

   macOS 和 LinuxWindows

   $ 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。