uv 简介
uv 是一款基于 Rust 开发的 Python 包管理和项目管理工具,主打极速体验。相比传统的 pip 和 virtualenv,它在依赖解析和环境创建上有着显著的性能优势。
安装方式
官方提供了两种主流的安装途径:
- PowerShell 脚本:适合初次接触且希望快速部署的用户。
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
- pip 安装:如果你已经配置好 Python 环境,这种方式更便捷。
pip install uv
推荐优先使用第二种方式,便于后续通过 pip 统一管理。
镜像源配置
在国内环境下,网络延迟往往是影响速度的主要因素。如果感觉 uv 运行缓慢,通常是因为默认镜像源的问题。建议手动配置国内镜像。
在文件路径栏输入 %APPDATA%,进入目录后新建 uv 文件夹,并在其中创建 uv.toml 配置文件,内容如下:
[[index]] url = "http://mirrors.aliyun.com/pypi/simple/" default = true
这里使用的是阿里云镜像源,你也可以替换为其他稳定的 PyPI 镜像地址。
虚拟环境管理
uv 支持两种环境管理模式:全局集中管理和项目独立管理。
全局模式
创建一个统一存放虚拟环境的目录(例如 ~/uvenv),然后在终端中执行:
uv venv env_name --python 3.11
激活环境:
env_name\Scripts\activate
提示:如果遇到权限报错,尝试以管理员身份运行 PowerShell,并执行
set-executionpolicy remotesigned解除限制。
安装或卸载包时,命令前加上 uv pip 即可:
uv pip install xxx
uv pip uninstall xxx
项目模式
对于具体项目,推荐使用本地化环境管理。
- 初始化项目:
uv init
这会生成 Git 仓库、依赖文件和项目元数据。
- 创建项目专属环境:
uv venv --python 3.11
- 添加依赖:
uv add xxx
此命令会自动更新项目依赖文档,无需手动维护 requirements.txt。
- 同步他人项目: 拿到别人的项目代码后,直接运行以下命令即可复刻完整环境:
uv sync


