Python 新一代三方库管理工具 uv
uv 是什么?
uv 是用 Rust 编写的 Python 包管理和项目管理工具,主打一个快。相比传统的 pip,它在依赖解析和安装速度上有显著提升。
uv 的安装
官网提供了两种主流安装方式:
- PowerShell 脚本安装(适合首次安装):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
- pip 安装(推荐):如果你已经安装了 Python,直接运行以下命令即可:
pip install uv
设置镜像源
虽然 uv 本身很快,但国内网络环境可能导致下载变慢。建议配置国内镜像源。
在文件资源管理器地址栏输入 %APPDATA%,进入后创建 uv 文件夹,并在其中新建 uv.toml 文件,内容如下:
[[index]] url = "http://mirrors.aliyun.com/pypi/simple/" default = true
这里使用的是阿里云镜像源,其他常用源同理。
创建虚拟环境
uv 支持两种虚拟环境管理模式:全局统一管理和跟随项目创建。
全局模式
创建一个集中存放虚拟环境的目录,例如 C:\Users\<用户名>\uvenv。打开终端进入该路径,使用以下命令创建环境:
uv venv env_name --python 3.xx
激活环境:
env_name\Scripts\activate
注意:如果遇到执行策略报错,请以管理员身份运行 PowerShell,执行
set-executionpolicy remotesigned解除限制。
在该环境下安装包时,只需在命令前加 uv:
uv pip install xxx
删除包则使用 uv pip uninstall。
配置 VSCode
由于 uv 是较新的工具,VSCode 默认可能无法识别其创建的虚拟环境,需要手动配置。
依次打开 VSCode -> 设置 -> 转换为 JSON 格式,在末尾添加以下内容:
"python.venvPath": "C:\\Users\\<用户名>\\uvenv",
"python.venvFolders": [ "C:\\Users\\<用户名>\\uvenv" ]
保存后重启 VSCode,通过命令面板搜索 即可看到并选择 uv 创建的环境。


