uv 简介
uv 是一款基于 Rust 开发的 Python 包管理和项目管理工具,主打极速体验。
安装方式
支持多种安装途径。若使用 PowerShell,可执行:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
更推荐直接使用 pip 安装,前提是已配置好 Python 环境:
pip install uv
配置镜像源
为了获得最佳下载速度,建议配置国内镜像源。在用户目录下创建配置文件:
- 打开文件资源管理器地址栏输入
%APPDATA%。 - 新建
uv文件夹并进入。 - 创建
uv.toml文件,填入以下内容(以阿里云为例):
[[index]] url = "http://mirrors.aliyun.com/pypi/simple/" default = true
虚拟环境管理
uv 支持集中式管理和项目级管理两种模式。
集中式管理
创建一个统一目录存放所有虚拟环境,例如 C:\Users\YourName\uvenv。
cd C:\Users\YourName\uvenv
uv venv env_name --python 3.11
激活环境:
env_name\Scripts\activate
注意:若遇到权限报错,可能需要以管理员身份运行 PowerShell 并设置执行策略:
Set-ExecutionPolicy RemoteSigned。
安装依赖命令与 pip 类似,只需前缀改为 uv:
uv pip install xxx
uv pip uninstall xxx
项目级管理
直接在项目根目录初始化:
uv init
这将自动创建 Git 仓库、依赖文件和项目元数据。随后创建对应版本的虚拟环境:
uv venv --python 3.11
添加依赖会自动更新项目文档:
uv add xxx
同步他人项目环境:
uv sync
VSCode 集成
由于 uv 创建的虚拟环境结构与传统不同,VSCode 可能无法自动识别。需在设置中手动指定路径。
- 打开 VSCode 设置,点击右下角'转换为 JSON'。
- 添加或修改以下配置项,指向你的虚拟环境存放目录:
{
"python.venvPath":


