uv 安装与 Python 版本管理

uv 是由 Astral 开发的超高速 Python 包管理和项目管理工具，同时支持 Python 版本管理。

uv 本身并不依赖 Python，因此不建议使用 pip 或 pipx 安装，否则会绑定到某个 Python 环境。

Windows 安装

官方安装（推荐）

在 PowerShell 中执行：

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

验证安装：

1
uv --version

Scoop 安装

如果已安装 Scoop：

1
scoop install uv

验证安装：

1
uv --version

配置 PATH

如果执行 uv 提示找不到命令，需要将安装目录加入环境变量。

CMD

1
set Path=D:\MyConfiguration\zichen2.liang\.local\bin;%Path%

PowerShell

1
$env:Path = "D:\MyConfiguration\zichen2.liang\.local\bin;$env:Path"

永久配置建议通过：

1
系统属性 → 高级 → 环境变量 → Path

添加：

1
D:\MyConfiguration\zichen2.liang\.local\bin

macOS 安装

官方安装（推荐）

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

验证安装：

1
uv --version

Homebrew 安装

如果已安装 Homebrew：

1
brew install uv

验证安装：

1
uv --version

配置 PATH

官方脚本默认安装到：

1
~/.local/bin

zsh（macOS 默认）

编辑配置：

1
nano ~/.zshrc

追加：

1
export PATH="$HOME/.local/bin:$PATH"

生效：

1
source ~/.zshrc

bash

编辑配置：

1
nano ~/.bashrc

追加：

1
export PATH="$HOME/.local/bin:$PATH"

生效：

1
source ~/.bashrc

查看安装位置

1
which uv

常见输出：

1
/Users/username/.local/bin/uv

或：

1
/opt/homebrew/bin/uv

（Homebrew 安装，Apple Silicon Mac）

Linux 安装

官方安装（推荐）

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

或者：

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

验证安装：

1
uv --version

配置 PATH

官方安装目录：

1
~/.local/bin

bash

编辑：

1
nano ~/.bashrc

追加：

1
export PATH="$HOME/.local/bin:$PATH"

生效：

1
source ~/.bashrc

zsh

编辑：

1
nano ~/.zshrc

追加：

1
export PATH="$HOME/.local/bin:$PATH"

生效：

1
source ~/.zshrc

fish

执行：

1
set -Ux fish_user_paths $HOME/.local/bin $fish_user_paths

重新打开终端即可。

查看安装位置

1
which uv

常见输出：

1
/home/username/.local/bin/uv

Python 版本管理

查看所有可安装版本

1
uv python list

安装最新版 Python

1
uv python install

安装指定版本

1
uv python install 3.10

安装多个版本

1
uv python install 3.10 3.11

查看 Python 安装目录

1
uv python dir

查找当前使用的 Python

1
uv python find

卸载指定版本

1
uv python uninstall 3.10

卸载多个版本

1
uv python uninstall 3.10 3.11

uv 常用命令

创建项目

1
2
uv init my-project
cd my-project

创建虚拟环境

1
uv venv

激活虚拟环境：

Windows

1
.venv\Scripts\activate

macOS / Linux

1
source .venv/bin/activate

安装依赖

1
uv add requests

安装开发依赖

1
uv add --dev pytest

删除依赖

1
uv remove requests

同步项目依赖

1
uv sync

运行 Python 脚本

1
uv run python main.py

运行模块

1
uv run -m package.module

更新与卸载

更新 uv

1
uv self update

卸载 uv

Windows

删除：

1
2
%USERPROFILE%\.local\bin\uv.exe
%USERPROFILE%\.local\bin\uvx.exe

并移除对应 PATH 配置。

macOS / Linux

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

并移除：

1
export PATH="$HOME/.local/bin:$PATH"

相关配置。

参考

官方文档：

https://docs.astral.sh/uv/

项目主页：

https://github.com/astral-sh/uv