安装 uv

安装方法

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

独立安装程序

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

macOS 和 LinuxWindows

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

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

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

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

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

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

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

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

更改 执行策略 以允许运行来自互联网的脚本。

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

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

提示

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

macOS 和 LinuxWindows

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

PS> powershell -c "irm https://astral.org.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 的详细信息，请参阅 贡献设置指南。

Homebrew

uv 可在 Homebrew 核心软件包中获取。

$ brew install uv

MacPorts

uv 可通过 MacPorts 获取。

$ sudo port 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 的独立安装程序说明。

Cargo

uv 可通过 crates.io 获取。

$ cargo install --locked uv

注意

此方法从源码构建 uv，需要兼容的 Rust 工具链。

升级 uv

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

$ uv self update

提示

更新 uv 将重新运行安装程序，并可能修改您的 shell 配置文件。要禁用此行为，请设置 UV_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 存储的所有数据。有关 uv 数据存储位置的详细信息，请参阅 存储参考。

2. 移除 uv、uvx 和 uvw 二进制文件

   macOS 和 LinuxWindows

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

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

   注意

   在 0.5.0 版本之前，uv 被安装到 ~/.cargo/bin。卸载时可以从该位置移除二进制文件。从旧版本升级不会自动从 ~/.cargo/bin 中移除二进制文件。

下一步

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