UV包管理工具使用技巧

Windows 超好用 Python 包管理工具 uv 保姆级安装使用教程

如果你还在忍受 pip 安装慢、虚拟环境配置繁琐、多 Python 版本管理混乱 的问题，那一定要试试 uv！

uv 是一款全新的极速 Python 包和虚拟环境管理工具，速度远超传统 pip、venv、pipenv，轻量化、零复杂配置，完美适配 Windows 系统，非常适合日常开发、项目搭建、版本切换。

今天给大家整理一套 Windows 系统下 uv 从零安装 + 全套实用指令，新手直接复制即用，一站式搞定 Python 环境管理！

一、uv 是什么？核心优势

极速安装：相比 pip 安装依赖速度提升数十倍
统一管理：兼顾 Python 版本、虚拟环境、项目依赖三大功能
轻量化：无需复杂配置，单指令安装，开箱即用
兼容所有旧生态：完美支持 requirements.txt、pyproject.toml，兼容 pip 所有使用习惯

二、Windows 系统安装 uv（一键指令）

1. 执行安装命令

打开 PowerShell（无需管理员权限），复制粘贴以下一键安装指令，回车即可自动完成安装：

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

安装脚本会自动适配你的电脑系统架构（x86_64/arm64），自动下载对应版本、配置基础文件，全程无需手动干预。

2. 临时配置环境变量

安装完成后，部分终端需要手动刷新环境变量，直接对应终端执行对应指令即可：

CMD 终端执行：

set Path=C:\Users\HP\.local\bin;%Path%

PowerShell 终端执行：

$env:Path = "C:\Users\HP\.local\bin;$env:Path"

💡 永久环境变量会由安装脚本自动写入注册表，重启终端即可永久生效。

3. 验证安装成功

重启 PowerShell，输入以下指令，输出版本号即代表安装完成：

uv --version

三、Python 版本管理核心指令

uv 最大的亮点就是可以多 Python 版本自由切换、一键安装指定版本，彻底告别手动官网下载安装包的麻烦。

1. 查看可安装的 Python 版本列表

uv python list

会展示所有官方可安装的 Python 版本，包含稳定版、测试版，可按需选择。

2. 一键安装指定 Python 版本

以常用的 3.12.13 稳定版为例：

uv python install 3.12.13

四、项目创建 & 虚拟环境配置

uv 内置虚拟环境功能，无需额外安装 venv、virtualenv，单指令创建、管理项目环境。

1. 创建全新 Python 项目

uv init demo_name

将 demo_name 替换为你的项目名，执行后自动生成标准 Python 项目结构和 pyproject.toml 配置文件。

2. 创建本地虚拟环境

进入项目根目录后，执行：

uv venv

自动在项目目录生成 .venv 虚拟环境文件夹，隔离项目依赖，不同项目互不干扰。

3. 同步项目依赖环境

当项目存在 pyproject.toml 配置文件时，执行以下指令可一键同步所有依赖，还原完整开发环境：

uv sync

五、项目依赖库管理（新增/删除）

uv 替代 pip 实现依赖管理，自动写入 pyproject.toml，无需手动记录依赖，更规范。

1. 安装/添加第三方库

uv add 库名

示例：安装 requests 库 uv add requests

执行后自动安装库，并更新到项目依赖配置文件中。

2. 卸载/移除第三方库

uv remove 库名

自动卸载库，同时清理依赖配置，无残留冗余。

六、项目 Python 版本更换（环境重构）

日常开发经常需要切换项目 Python 版本，uv 只需三步即可无损重构环境，非常便捷：

步骤1：为当前项目锁定指定 Python 版本

uv python pin 3.12.13

步骤2：删除旧的虚拟环境

rm -r .venv -Force

步骤3：用新版本重新创建虚拟环境

uv venv

重构完成后，执行 uv sync 即可重新安装所有适配新版本的依赖库。

七、依赖文件导入/导出（适配旧项目）

uv 完美兼容传统的requirements.txt，支持双向导入导出，适配所有老项目迁移。

1. 从 requirements.txt 安装依赖

uv pip install -r requirements.txt

2. 将当前环境依赖导出为 requirements.txt

uv pip freeze > requirements.txt

3. 从 pyproject.toml 导出为 requirements.txt

适配现代化项目，将规范配置文件转为传统依赖文件：

uv pip compile pyproject.toml -o requirements.txt

4. 批量导入 requirements.txt 依赖到项目

将传统依赖文件批量写入 pyproject.toml，完成项目规范化升级：

uv add -r requirements.txt

八、总结

uv 完全可以替代传统的 pip + venv 组合，一套工具搞定：Python 版本切换、虚拟环境创建、依赖安装/卸载、环境迁移同步，速度更快、操作更简洁、项目管理更规范。

这套全流程指令覆盖了 Windows 平台日常 Python 开发 99% 的场景，新手可以直接收藏，后续开发全程复用！