当前位置:首页>python>Windows 下的极速 Python 环境管理工具 uv 完全指南

Windows 下的极速 Python 环境管理工具 uv 完全指南

  • 2026-09-15 09:29:37
Windows 下的极速 Python 环境管理工具 uv 完全指南

如果你在使用 Python 时,常常因为 pip install 缓慢的解析速度而感到烦躁,或者被繁杂的虚拟环境管理工具(venv, virtualenv, conda)搞得晕头转向,那么 uv 就是为你准备的终极解决方案。

uv 是一个由 Rust 编写的极速 Python 包和项目管理器。它旨在全面替代 pip、pip-tools 和 virtualenv。

01
为什么选择 uv?
  • ⚡ 极致的速度: 依托 Rust 的性能和全局缓存机制,安装依赖往往只需几百毫秒。

  • 🛠️ 开箱即用: 不依赖系统预装的 Python 即可工作,甚至可以帮你自动下载和管理多个 Python 版本。

  • 🎯 100% 兼容 API: 支持标准 requirements.txt 和 pyproject.toml,迁移成本几乎为零。

02

在 Windows 上安装 uv

在 Windows 上安装 uv 非常简单,官方推荐使用 PowerShell 脚本。

  1. 打开你的 PowerShell(建议以管理员身份运行,或者在普通权限下运行也可安装在用户目录)。

  2. 复制并运行以下命令:

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

备选方案:如果你已经有了 Python 环境,也可以直接用 pip 安装(但不推荐,因为用独立脚本安装会让 uv 脱离特定 Python 环境的束缚):pip install uv

安装完成后,重启终端,输入 uv --version 测试是否安装成功。

03

玩转虚拟环境 (Virtual Environments)

uv 的核心优势之一就是极速创建和管理虚拟环境。

1. 创建基础虚拟环境

在你的项目根目录下,打开终端(CMD 或 PowerShell),输入:

uv venv

不到一秒钟,uv 就会在当前目录下创建一个名为 .venv 的文件夹。

2. 指定 Python 版本

如果你的电脑上没有某个版本的 Python,或者想使用特定版本,uv 可以自动帮你下载并创建:

uv venv --python 3.12

注:uv 会自动从后台拉取隔离的 Python 3.12 环境,不会污染你的系统全局变量。

3. 激活虚拟环境 (Windows 专属路径)

创建好之后,使用以下命令激活它(注意 Windows 下的路径是 Scripts):

CMD / PowerShell:

.venv\Scripts\activate
激活后,你的命令行提示符前面会出现 (.venv) 字样。
04
像飞一样管理依赖

激活环境后,你可以把 uv pip 当作更快的 pip 来使用。

1. 安装包

# 单独安装uv pip install requests# 从 requirements.txt 安装uv pip install -r requirements.txt

你会立刻感受到由于 Rust 并发下载和硬链接(Hardlink)缓存带来的震撼速度。

2. 导出依赖

如果你需要生成 requirements.txt 分享给别人,uv 同样能搞定:

uv pip freeze > requirements.txt

3. 卸载或同步

# 卸载包uv pip uninstall requests# 根据文件同步环境(移除未在 requirements.txt 中的包)uv pip sync requirements.txt
05

进阶杀手锏 — uv run

如果你觉得每次都要输入 .venv\Scripts\activate 还是很麻烦,uv 提供了一个超级方便的命令:uv run。

你完全不需要激活虚拟环境,只要当前目录下有 .venv,直接使用 uv run,它就会自动在虚拟环境中执行命令或脚本:

# 直接运行 Python 脚本uv run main.py# 在虚拟环境中启动 Jupyter Notebook (前提是已安装)uv run jupyter notebook# 甚至可以直接运行包含内联依赖声明 (PEP 723) 的独立脚本uv run https://raw.githubusercontent.com/astral-sh/uv/main/scripts/app.py
💡 总结

在 Windows 上使用 uv 只需要记住三个核心动作:

  1. uv venv (建环境)

  2. .venv\Scripts\activate (激活环境) 或 直接使用 uv run (懒人福音)

  3. uv pip install (装包)

赶快把你的老旧 pip 命令替换掉,享受秒级响应的 Python 开发体验吧!

最新文章

随机文章