Python 环境管理新选择:uv 极速入门指南

什么是 uv？

uv 是由 Astral 团队（也就是 ruff 的开发者）打造的新一代 Python 包管理工具。它整合了 pip、venv、pip-tools 等多个工具的功能，用一个命令就能搞定所有依赖管理需求。

核心亮点：

• 极速安装：基于 Rust 实现，速度碾压传统工具
• 一站管理：包安装、虚拟环境、依赖锁定全部搞定
• 完全兼容：支持 pyproject.toml，与现有项目无缝衔接
• 跨平台支持：Windows、macOS、Linux 通吃

官方资源：

• GitHub: https://github.com/astral-sh/uv
• 文档: https://docs.astral.sh/uv/

安装 uv

本文以 Windows 平台为例，其他系统可以参考官方文档。

快速安装

打开 PowerShell，执行以下命令：

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

命令解析：

• -ExecutionPolicy ByPass：临时绕过 PowerShell 执行策略限制（仅当前会话有效）
• -c：执行后面的命令脚本

安装完成后，验证一下：

uv --version

看到版本号输出，说明安装成功！

自定义安装路径

如果不想装到默认位置，可以指定安装目录（比如安装到 D:\soft\uv）：

powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "D:\soft\uv";irm https://astral.sh/uv/install.ps1 | iex}

配置国内镜像源

安装好后，第一件事就是配置国内镜像源，让下载速度起飞。以清华源为例：

[Environment]::SetEnvironmentVariable("UV_DEFAULT_INDEX", "https://pypi.tuna.tsinghua.edu.cn/simple/", "User")

提示：其他镜像源（如阿里云、豆瓣等），只需替换 URL 即可。

创建虚拟环境

Python 项目开发必备 —— 虚拟环境，用来隔离不同项目的依赖。

1. 创建环境

uv venv --python 3.13

这条命令会在当前目录创建 .venv 文件夹，并安装指定版本的 Python。

2. 激活环境

.\.venv\Scripts\activate

激活后，命令行前面会出现 (venv) 标识，表示已进入虚拟环境。这时候就可以愉快地用 uv pip install 安装依赖了！

常用命令速查

写在最后

uv 的出现确实给 Python 生态带来了一股新风。它不仅仅是快，更重要的是简化流程 —— 一个工具替代多个工具，让开发者能更专注于代码本身。

如果你是 Python 开发者，强烈推荐尝试一下。相信用过之后，你会和我一样，再也回不去传统的 pip 时代了！

以上就是 uv 的快速入门指南，觉得有用的话，欢迎点赞、在看、转发三连！有问题可以在评论区留言交流~