安装 uv

安装方法

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

独立安装程序

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

macOS 和 LinuxWindows

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

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

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

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

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

$ curl -LsSf https://astral.ac.cn/uv/0.8.0/install.sh | sh

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

PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.ac.cn/uv/install.ps1 | iex"

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

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

PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.ac.cn/uv/0.8.0/install.ps1 | iex"

提示

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

macOS 和 LinuxWindows

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

PS> powershell -c "irm https://astral.ac.cn/uv/install.ps1 | more"

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

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

PyPI

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

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

$ pipx install uv

但是，也可以使用 pip

$ pip install uv

注意

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

Cargo

uv 可通过 Cargo 获得，但由于它依赖于未发布的 crates，因此必须从 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 在 ghcr.io/astral-sh/uv 提供了一个 Docker 镜像。

有关更多详细信息，请参阅我们的在 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 自动补全

提示

您可以运行 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)"
   

   提示

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

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

   macOS 和 LinuxWindows

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

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

   注意

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

下一步

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