Windows 系统下使用 Python 的 UV的教程

Windows 系统下使用 Python 的 UV 教程

安装 UV

通过 pip 安装（推荐）

直接使用 Python 自带的 pip 安装，兼容性最佳。

pip install uv

使用 PowerShell 脚本安装

打开 PowerShell，执行以下命令：

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

使用 winget 安装

如果已安装 winget，可以使用以下命令：

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

使用 pipx 安装

如果已安装 pipx：

pipx install uv

直接下载安装包

从 UV 官方 GitHub 仓库下载 uv-x86_64-pc-windows-msvc.zip，解压后将解压后的文件夹目录设置环境变量即可生效。

验证安装

安装完成后，打开命令提示符或 PowerShell，输入以下命令来验证 UV 是否安装成功：

uv --version

基础用法

创建虚拟环境

uv venv .venv  # 在当前目录下创建一个名为 .venv 的虚拟环境，使用系统默认的 Python 版本
uv venv -p 3.12  # 指定 Python 版本（需已安装）

激活虚拟环境：

.venv\Scripts\activate  # Windows

安装依赖包

语法与 pip 一致，但速度更快。

uv pip install requests  # 安装 requests 包
uv pip install Flask==2.2.2  # 安装指定版本的 Flask 包
uv pip install -r requirements.txt  # 从 requirements.txt 文件安装所有依赖

卸载包

uv pip uninstall requests  # 卸载 requests 包
uv pip uninstall Flask Werkzeug  # 卸载多个包

列出已安装的包

uv pip list

项目管理

初始化项目

创建一个新项目，会生成默认的文件和目录结构。

uv init myproject
cd myproject

添加依赖

uv add requests
uv add "numpy==1.23.4"

同步项目依赖

uv sync

运行项目

uv run main.py

导出依赖

uv pip freeze > requirements.txt

Python 版本管理

安装特定版本的 Python

uv python install 3.12

也可以安装多个版本：

uv python install 3.11 3.12

查看已安装的 Python 版本

uv python list

更换国内源

项目配置

在 pyproject.toml 文件中添加：

[[tool.uv.index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true

或在 uv.toml 文件中添加：

[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true

环境变量

在终端中临时设置：

uv add --default-index https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple fastmcp

或在系统中永久设置：

vi ~/.bashrc
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
export EXTRA_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple