uv安装指南

在开始使用uv之前，您需要在系统上安装它。本指南将详细介绍在不同操作系统上安装uv的方法，以及如何验证安装是否成功。

系统要求

在安装uv之前，请确保您的系统满足以下要求：

  • 支持的操作系统：Windows 7及以上、macOS 10.12及以上、主流Linux发行版
  • Python 3.7 或更高版本（用于运行Python项目）
  • 足够的磁盘空间（约50MB）

Windows系统安装

在Windows系统上有多种方式安装uv：

方法一：使用PowerShell安装（推荐）

powershell 
# 打开PowerShell终端，运行以下命令
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

方法二：使用winget安装

bash 
# 如果您已安装winget
winget install -e --id AstralSh.UV

方法三：手动下载安装

  1. 访问uv GitHub发布页面
  2. 下载适用于Windows的可执行文件（uv-installer.exe）
  3. 运行安装程序并按照提示完成安装

macOS系统安装

在macOS上有多种方式安装uv：

方法一：使用curl安装（推荐）

bash 
# 打开终端，运行以下命令
curl -LsSf https://astral.sh/uv/install.sh | sh

方法二：使用Homebrew安装

bash 
# 如果您已安装Homebrew
brew install uv

方法三：使用MacPorts安装

bash 
# 如果您已安装MacPorts
sudo port install uv

Linux系统安装

在Linux系统上安装uv：

方法一：使用curl安装（推荐）

bash 
# 打开终端，运行以下命令
curl -LsSf https://astral.sh/uv/install.sh | sh

方法二：使用pip安装

bash 
# 使用pip安装（需要Python 3.7+）
pip install uv

# 或者使用pipx安装（推荐）
pipx install uv

方法三：使用包管理器安装

bash 
# Ubuntu/Debian
sudo apt install uv

# Fedora
sudo dnf install uv

# Arch Linux
sudo pacman -S uv

验证安装

安装完成后，可以通过以下方式验证uv是否正确安装：

bash 
# 检查uv版本
uv --version

# 查看uv帮助信息
uv --help

# 验证基本功能
uv python list

常见问题和解决方案

1. 安装后命令未找到

这通常是因为安装路径未添加到系统PATH环境变量中：

bash 
# 在Linux/macOS中，将以下行添加到~/.bashrc或~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

# 然后重新加载配置
source ~/.bashrc  # 或 source ~/.zshrc

2. 权限问题

在Linux/macOS系统上，可能需要使用sudo权限：

bash 
# 使用sudo安装到系统目录
sudo curl -LsSf https://astral.sh/uv/install.sh | sudo sh

3. 防火墙或代理问题

如果您的网络环境有防火墙或代理限制，可以手动下载安装：

  1. 访问uv GitHub发布页面
  2. 下载适用于您系统的二进制文件
  3. 将其解压并添加到PATH环境变量中

4. 在虚拟环境中使用uv

建议在虚拟环境中使用uv以避免与其他项目产生冲突：

bash 
# 创建虚拟环境
python -m venv myproject

# 激活虚拟环境
# Windows:
myproject\Scripts\activate
# macOS/Linux:
source myproject/bin/activate

# 在虚拟环境中安装uv
pip install uv

卸载uv

如果需要卸载uv，可以使用以下方法：

使用安装脚本卸载

bash 
# 运行卸载脚本
curl -LsSf https://astral.sh/uv/uninstall.sh | sh

手动卸载

bash 
# 删除可执行文件
rm ~/.local/bin/uv

# 删除相关目录（如果存在）
rm -rf ~/.cache/uv
rm -rf ~/.local/share/uv