uv安装指南

uv 是一个用 Rust 编写的极速 Python 包和项目管理器。本文整理自 uv 中文文档 - 安装方法，汇总 uv 的各种安装方式与日常维护命令。

安装前准备

安装 uv 之前，建议先卸载任何现有的 uv 版本，并检查是否安装了 uvx 命令（通常在 $HOME/.local/bin 或 %USERPROFILE%\.local\bin 目录下），如果存在请一并删除，以避免安装后命令冲突。

安装方法

方式一：独立安装程序（推荐）

uv 提供了独立安装程序，可以直接下载并安装。

macOS / Linux（使用 curl）：

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

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

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

Windows（使用 PowerShell）：

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

方式二：从 PyPI 安装

如果从 PyPI 安装，建议使用 pipx 将 uv 安装到隔离环境中，也可以使用 pip：

1
2
3

pipx install uv
# 或
pip install uv

方式三：使用 Homebrew 安装（macOS / Linux）

1	brew install uv

方式四：使用 WinGet 安装（Windows）

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

方式五：使用 Scoop 安装（Windows）

1	scoop install main/uv

方式六：使用 Cargo 安装

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

注意：从 Cargo 安装时，默认构建使用 jemalloc。如需禁用此功能，请在构建时添加 --no-default-features 参数。

方式七：使用 conda / mamba 安装

1	conda install -c conda-forge uv

方式八：使用 Pacman 安装（Arch Linux）

1	pacman -S uv

安装脚本选项

独立安装脚本支持通过环境变量进行自定义配置：

环境变量	说明
`UV_INSTALL_DIR`	指定 uv 的安装目录
`INSTALLER_NO_MODIFY_PATH`	设置为 `1` 时，不会修改 shell 配置文件（如 PATH 环境变量）
`GITHUB_TOKEN`	用于从 GitHub 下载时进行身份验证（避免速率限制）

启用 Shell 自动补全

安装 uv 后，可以为 shell 配置自动补全功能：

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

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

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

PowerShell：

1	Add-Content -Path $PROFILE -Value '(& uv generate-shell-completion powershell) \| Out-String \| Invoke-Expression'

更新 uv

uv 自带更新功能，运行以下命令即可更新到最新版本：

1	uv self update

重要提示：只有通过独立安装程序安装的 uv 才支持 uv self update 命令。通过其他包管理器（如 pip、Homebrew 等）安装的 uv，请使用对应的包管理器进行更新。

卸载 uv

如果需要卸载 uv，请按照以下步骤操作：

删除 uv 及其相关文件：

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

删除 uv 可执行文件（安装目录默认为 ~/.local/bin）：

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

如果安装程序修改了 shell 配置文件（如 .bashrc、.zshrc），请检查并删除相关的内容。

参考链接

uv 中文文档 - 安装方法：https://uv.doczh.com/getting-started/installation/
uv GitHub 仓库：https://github.com/astral-sh/uv