Python 新一代包管理工具 uv
uv 是什么?
uv 是用 Rust 语言编写的 Python 包和项目管理工具,详见官网。

uv 的安装
官网上提供了两种安装方式。第一种需要在 PowerShell 终端里运行以下命令:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
另一种方式是如果已经安装过 Python,可以直接使用 pip 安装:
pip install uv
设置镜像源
虽然 uv 速度很快,但有时感觉较慢,通常是因为镜像源问题。建议配置国内镜像源。
手动在文件路径栏输入 %APPDATA%,在该目录下创建 uv 文件夹并进入。然后在 uv 文件夹里创建 uv.toml 文件并打开,内容为:
[[index]] url = "http://mirrors.aliyun.com/pypi/simple/" default = true
注:url 为 Python pip 的镜像源地址,阿里云镜像源仅为示例,其他可用镜像源亦可。
创建虚拟环境
uv 创建虚拟环境有两种方式:统一创建管理或跟随项目创建。这里介绍统一创建方式。
首先创建一个 uvenv 文件夹用于集中放置虚拟环境,例如 C:\uvenv。
打开 cmd 进入该路径,使用如下命令创建虚拟环境,其中 env_name 为虚拟环境命名,--python 指定 Python 版本:
uv venv env_name --python 3.xx
此时虚拟环境已创建,运行以下命令激活:
env_name\Scripts\activate
注意:如果遇到报错,可尝试以管理员身份运行 PowerShell,执行
set-executionpolicy remotesigned解除限制。
接下来即可在该虚拟环境下安装 Python 三方库,安装命令直接在 pip install 前加入 uv 即可:
uv pip install xxx
删除某个库与 pip 类似,运行 uv pip uninstall 即可。
配置 VSCode
由于 uv 是新出的工具,VSCode 可能无法自动索引创建的虚拟环境,需进行配置。
依次打开 VSCode、设置、转换为 JSON,并在最后添加以下内容(注意替换为你的实际路径):
{
"python.venvPath": "C:\\uvenv",
"python.venvFolders": ["C:\\uvenv"]
}


至此 VSCode 就能检测到 uv 所创建的虚拟环境了。可以运行命令面板,输入 Python: Select Interpreter 进行验证。

使用 uv 进行项目管理
首先用 VSCode 打开一个空项目(空文件夹),在终端里运行 uv init,即可对项目进行初始化,会自动创建 Git 管理、Python 环境依赖和项目信息。
在该项目下,可以在终端输入 uv venv --python 3.xxx,即可以创建适合该项目的 Python 版本。
然后再次运行 uv venv 即可以创建适合该项目的虚拟环境。

使用 uv add xxx 即可给该项目环境安装具体的三方库,且项目环境文档会自动更新!

另外,拿到别人的项目的话可以使用 uv sync 对他人项目环境进行复制。

uv 项目管理常用命令小结
uv init: 初始化项目uv venv: 创建虚拟环境uv add: 添加依赖uv sync: 同步依赖


