Python 安装指南

是一个用 Rust 编写的极速 Python 包和项目管理器，集成了 pip、pyenv、virtualenv 等工具的功能，速度比传统工具快 10-100 倍。

Windows 安装

• 方式一：使用 PowerShell 脚本（推荐）

  使用 PowerShell 安装 uv：

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

  安装指定版本：

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

• 方式二：使用 WinGet

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

在新的终端窗口中验证安装：

uv --version

Debian 安装

1. 安装 uv

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

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

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

2. 配置 shell 环境

   安装脚本会自动配置环境。如果需要手动配置，将以下内容添加到 ~/.bashrc：

   # uv
   export PATH="$HOME/.local/bin:$PATH"

3. 重新加载配置文件

   source ~/.bashrc

4. 验证安装

   uv --version

常用命令

# 查看可用的 Python 版本
uv python list

# 查看已安装的版本
uv python list --only-installed

# 安装最新版本 Python
uv python install

# 安装指定版本 Python
uv python install 3.11.0

# 安装多个版本 Python
uv python install 3.11 3.12 3.13

# 设置默认 Python 版本
uv python install 3.11 --default

# 创建项目（自动使用项目的 Python 版本）
uv init myproject
cd myproject
uv sync

# 运行 Python
uv run python script.py

# 安装包
uv add requests

# 升级 uv
uv self update

版本管理

uv 通过项目自动管理 Python 版本：

1. 在项目根目录创建 .python-version 文件指定版本
2. 使用 uv python pin 3.11 固定项目 Python 版本
3. uv 会自动检测并使用合适的 Python 版本