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包管理体验,特别适合需要高性能依赖解析和安装的开发场景。