1.1 安装

  3 分钟阅读  

原文链接: https://docs.astral.sh/uv/getting-started/installation/

1.1 安装

安装方式

你可以使用我们的独立安装器或你偏好的包管理器来安装 uv。

独立安装器

uv 提供了独立安装器来下载并安装 uv：

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

1

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

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

1

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

在 URL 中指定版本即可请求特定版本：

1

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

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

1

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

更改执行策略后即可运行来自互联网的脚本。

在 URL 中指定版本即可请求特定版本：

1

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

提示

使用安装脚本之前可以先检查它的内容：

> > > > > >
1

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

1

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

另外，安装器或二进制文件也可以直接从 GitHub 下载。

关于自定义 uv 安装的细节，请参阅安装器的参考文档。

PyPI

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

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

1

$ pipx install uv

不过，也可以使用 pip：

1

$ pip install uv

注意

uv 为许多平台提供了预构建的分发包（wheel）；如果某个平台没有可用的 wheel，uv 将从源码构建，这需要 Rust 工具链。从源码构建 uv 的细节请参阅贡献指南。

Homebrew

uv 已在 Homebrew 核心软件包中提供。

1

$ brew install uv

MacPorts

uv 可通过 MacPorts 安装。

1

$ sudo port install uv

WinGet

uv 可通过 WinGet 安装。

1

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

Scoop

uv 可通过 Scoop 安装。

1

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

1

$ cargo install --locked uv

注意

这种方式会从源码构建 uv，因此需要兼容的 Rust 工具链。

升级 uv

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

1

$ uv self update

提示

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

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

1

$ pip install --upgrade uv

Shell 自动补全

提示

你可以运行 echo $SHELL 来帮助确定自己使用的 shell。

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

1

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

1

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

1

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

1

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

1
2
3
4

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

1

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

1

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

1

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

1

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

1
2
3
4

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. 清理已存储的数据（可选）：

    1
2
3

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

    提示

    在移除二进制文件之前，你可能想先删除 uv 已存储的数据。uv 存储数据的位置请参阅存储参考。

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

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

    ```pwsh
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。

最后修改 September 25, 2026: 更新 (221c74c33)