20_uv_wsl_installation

windows11 #wsl

在Windows 11 WSL上安装uv的完整指南

概述

uv是由Astral公司开发的现代化Python包管理器和项目管理工具，用Rust编写，提供极快的速度和统一的工具链，可替代pip、pip-tools和virtualenv。

安装方法

方法一：官方安装脚本（推荐）

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc  # 或 source ~/.zshrc

方法二：包管理器安装

• Homebrew: brew install uv
• Ubuntu/Debian: 使用官方安装脚本

方法三：预编译二进制文件

mkdir -p ~/.local/bin
wget -qO ~/.local/bin/uv https://github.com/astral-sh/uv/releases/latest/download/uv-x86_64-unknown-linux-gnu.tar.gz
cd ~/.local/bin && tar -xzf uv-x86_64-unknown-linux-gnu.tar.gz
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

方法四：pipx安装

python3 -m pip install --user pipx
python3 -m pipx ensurepath
pipx install uv

验证安装

uv --version
uv --help
which uv

常见问题解决

• uv: command not found: 检查PATH设置
• 权限错误: 使用chmod +x添加执行权限
• 网络问题: 设置代理或检查连接
• 架构不匹配: 使用uname -m检查并下载正确版本

基本使用

# 创建项目
uv init my_project && cd my_project

# 管理依赖
uv add requests pandas
uv add --dev pytest black

# 虚拟环境
uv venv && source .venv/bin/activate

# 运行脚本
uv run script.py

uv在WSL环境中工作良好，提供了快速、现代的Python包管理体验，特别适合需要高性能依赖解析和安装的开发场景。