【系统】Windows 安装 uv

IT里的交易员2026-05-11 10:56

文章目录

前言
一、uv是什么？
二、一键安装uv
- [1. PowerShell 一键安装（官方推荐，最省事）](#1. PowerShell 一键安装（官方推荐，最省事）)
- [2. 国内加速（可选，解决下载慢）](#2. 国内加速（可选，解决下载慢）)
常见问题

前言

提示：这里可以添加本文要记录的大概内容：

例如：随着人工智能的不断发展，机器学习这门技术也越来越重要，很多人都开启了学习机器学习，本文就介绍了机器学习的基础内容。

提示：以下是本篇文章正文内容，下面案例可供参考

一、uv是什么？

uv 是一个用 Rust 写的、极快的 Python 包管理器 + 环境管理器，可以把它理解成：Python 界的 "极速全能工具"，用来替代 pip、venv、virtualenv、pip-tools 等一堆工具。装包、建虚拟环境、锁依赖、管理 Python 版本，全都能做。以前 pip 装要几分钟的，uv 通常几秒搞定。

简单比喻

pip = 自行车（慢、功能单一）
uv = 摩托车（快、全能、还省油）

常用命令（和 pip 很像）：

powershell 复制代码

uv pip install 包名   # 兼容 pip 写法
uv add 包名            # uv 原生写法（推荐）
uv sync                # 安装/更新所有依赖
uv run python main.py  # 在虚拟环境里运行脚本

二、一键安装uv

1. PowerShell 一键安装（官方推荐，最省事）

打开 PowerShell（不用管理员也行）：

Win+X → 选 Windows PowerShell 或终端

复制下面一行，直接粘贴回车：

powershell 复制代码

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

等待跑完（会自动下载、解压、加环境变量）。

关掉当前 PowerShell，重新开一个，验证：

powershell 复制代码

uv --version

能显示版本号（如 uv 0.8.22）就成功。

2. 国内加速（可选，解决下载慢）

在终端里先设清华源：

powershell 复制代码

$env:UV_DEFAULT_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"

常见问题

"uv 不是内部或外部命令"：必须新开终端，环境变量才生效。

PowerShell 禁止运行脚本：用方法一那条带 -ExecutionPolicy ByPass 的命令即可。