Python 内置 venv 虚拟环境工具使用及 uv 升级教程

查看虚拟环境 核心逻辑：venv 创建的虚拟环境本质是普通文件夹，没有专属的查询命令，需通过系统的文件查询指令查看。

不同系统操作：

示例（Linux/macOS）：

# 查看当前目录下的虚拟环境
ls
# 输出：my_project_venv my_project_venv_with_global（两个虚拟环境文件夹）
# 查看指定目录下的虚拟环境（如~/projects/venvs/）
ls ~/projects/venvs/

（三）补充操作：删除虚拟环境

venv 虚拟环境是普通文件夹，直接删除对应文件夹即可（删除后不可恢复，需谨慎操作）：

（四）venv 核心总结

venv 轻量、无额外依赖，是简单 Python 项目环境隔离的首选工具。基础隔离模式适合大多数场景，--system-site-packages 参数则为大型依赖复用提供了便捷方案，可根据项目需求灵活选择～

二、uv 包管理工具使用教程（兼容 venv，性能翻倍）

uv 是基于 Rust 开发的现代化 Python 环境 + 包管理工具，一站式整合「虚拟环境管理 + 高性能包安装 + 依赖解析 + 依赖锁定」功能，完全兼容 venv 的所有操作逻辑，且速度是 venv+pip 组合的 10~100 倍。对于中大型项目、团队协作或追求开发效率的场景，uv 是 venv 的最优升级替代方案。

（一）前提准备：安装 uv

uv 需手动安装，但安装过程极简，支持所有系统和架构（包括 ARM64 架构如 Jetson 设备）：

临时使用清华镜像源安装 uv（推荐）

python3 -m pip install uv --user -i https://pypi.tuna.tsinghua.edu.cn/simple

若清华源不行，换阿里云镜像源

python3 -m pip install uv --user -i https://mirrors.aliyun.com/pypi/simple/

安装验证：重启终端后执行以下命令，输出版本号即安装成功：

uv --version

（二）核心操作详解（与 venv 无缝兼容，零学习成本）

uv 的虚拟环境操作逻辑与 venv 完全一致，核心命令仅将 python3 -m venv 替换为 uv venv，激活、退出、查看、删除命令与 venv 完全相同，无需记忆新指令。

1. 创建虚拟环境 （1）基础创建（默认隔离模式） 命令格式：

   # 基础命令：在当前目录创建名为【环境名】的虚拟环境（默认不继承系统全局包）
   uv venv 环境名 
   

   示例：

   # 创建名为 my_project_uv 的虚拟环境（隔离模式，与 venv 目录结构一致）
   uv venv my_project_uv 
   

   说明：uv 创建的虚拟环境文件夹与 venv 完全相同，包含 Python 解释器、pip 工具（可直接用 uv pip 替代），默认隔离系统全局包。

   若系统存在多个 Python 版本，可指定具体版本创建：

   uv venv --python python3.8 my_project_uv_38 # 使用 Python3.8 创建虚拟环境
   uv venv --python python3.10 my_project_uv_310 # 使用 Python3.10 创建虚拟环境
   

   （2）带 --system-site-packages 参数创建（继承系统全局包） uv 完全支持 venv 的 --system-site-packages 参数，作用和适用场景与 venv 一致，完美复用系统全局大型依赖包： 命令格式与示例：

   # 带系统包继承的创建命令（与 venv 参数完全一致）
   uv venv --system-site-packages 环境名
   # 示例：创建继承系统全局包的 uv 虚拟环境
   uv venv --system-site-packages my_project_uv_with_global 
   

   关键注意事项：与 venv 完全相同，仅在创建时同步系统包，虚拟环境内安装的包优先级高于继承的系统包。

2. 查看虚拟环境 与 venv 完全一致！uv 创建的虚拟环境本质也是普通文件夹，通过系统命令 ls（Linux/macOS）、dir（Windows CMD）、Get-ChildItem（Windows PowerShell）查看即可。

3. 激活虚拟环境 命令与 venv 完全相同！无需修改任何操作习惯，激活后终端前缀同样显示环境名： 示例（Linux/macOS）：

   # 激活 uv 创建的虚拟环境（命令与 venv 一致）
   source my_project_uv_with_global/bin/activate 
   

   激活成功标识、验证方法与 venv 完全一致，可通过 which python3 或 pip list 验证。

4. 退出虚拟环境 命令与 venv 完全相同！所有系统通用：

   deactivate
   

（三）补充操作：删除虚拟环境

与 venv 完全一致！uv 虚拟环境也是普通文件夹，直接删除对应文件夹即可： 示例（Linux/macOS）：

rm -rf my_project_uv_with_global

（四）uv 专属亮点：一站式高性能包管理（uv pip）

uv 的核心优势在于内置高性能 pip 替代工具 uv pip，完全兼容 pip 的所有参数和用法，且速度提升 10~50 倍，支持依赖锁定、并行安装、智能依赖解析等高级功能。

1. 基础包安装（兼容 pip 所有命令） 将 pip 替换为 uv pip 即可，无需修改任何参数：

   # 安装单个包
   uv pip install requests
   # 安装指定版本包
   uv pip install pandas==2.1.0
   # 从 requirements.txt 安装依赖
   uv pip install -r requirements.txt
   # 安装私有源包
   uv pip install -i https://pypi.tuna.tsinghua.edu.cn/simple torch 
   

2. 依赖锁定（团队协作必备） uv 支持生成规范的锁文件 uv.lock，记录完整依赖树和版本信息，确保团队所有成员环境一致：

   # 从 requirements.txt 生成锁文件
   uv pip compile requirements.txt -o uv.lock
   # 基于锁文件安装依赖（确保环境 100% 一致）
   uv pip sync uv.lock 
   

3. 性能优势 在相同环境下，uv pip install 安装依赖的速度远快于 pip install，尤其是大型包或多依赖项目：

   • 安装 Pandas 等大型科学计算包：速度提升 10~20 倍；
   • 解析复杂依赖树（如 100+ 子依赖）：速度提升 100+ 倍；
   • 团队协作同步环境：基于锁文件的 uv pip sync 比 pip install -r 快 5~10 倍。

（五）uv 纯净环境的 pip 调用'踩坑'问题

这是一个非常经典且容易'踩坑'的问题，特别是对于刚开始使用 uv 这种现代化工具的用户。uv 创建虚拟环境的逻辑与传统的 python -m venv 不同，它默认创建一个**'纯净（Bare）'**环境，不包含 pip、setuptools 或 wheel。以下是两种使用场景的详细解析：

1. 结论速览

若不运行 uv pip install pip，直接敲 pip 极大概率把包装到系统里，违背虚拟环境的初衷，务必小心！

2. 详细原理解析

• 情况一：用 uv 创建环境后，未安装 pip 运行 uv venv 并激活 (source .venv/bin/activate) 后，环境变量 PATH 会被修改，.venv/bin 被放在最前面，但 uv 默认环境中无 pip 可执行文件。Shell 在 .venv/bin 找不到 pip 时，会顺着 PATH 找到系统的 /usr/bin/pip。后果：终端提示符显示虚拟环境，但 pip 实际是系统的，包会装到 /usr/local/lib/python3.10/dist-packages（系统目录）或 ~/.local/lib/...（用户目录），完全绕过虚拟环境。验证方法：执行 which pip，输出路径为系统路径（如 /usr/bin/pip）。

• 情况二：使用 uv pip install pip 安装后 这是某些测试案例中的操作：uv pip install pip 会将 pip 下载并安装到虚拟环境的 bin 目录 (.venv/bin/pip)。此时输入 pip，Shell 会优先找到虚拟环境内的 pip。后果：pip 是虚拟环境私有，包会被正确安装到 .venv/lib/python3.x/site-packages。

3. 最佳实践建议

既然使用了 uv，建议改变使用习惯，避免混用 pip 命令，以获得最快的速度和最稳定的体验：

替代做法（习惯用 pip 时）：先安装 pip 再使用

uv pip install pip # 先把 pip 装进虚拟环境
pip install torch # 然后再用 pip 

推荐做法：完全不安装 pip，直接使用 uv 管理包（速度最快）

uv pip install torch numpy # 直接装入当前激活的虚拟环境 

⚠️ 总结：若不运行 uv pip install pip，直接敲 pip 极大概率把包装到系统里，违背虚拟环境的初衷，务必小心！

三、venv vs uv 核心对比表

四、最终选型建议

1. 选 venv 的场景：
   • 设备无网络，无法安装 uv；
   • 仅需简单环境隔离，项目依赖极少；
   • 追求绝对零安装、零风险，无需高级包管理功能。
2. 选 uv 的场景：
   • 中大型项目、多依赖项目（如深度学习、Web 开发）；
   • 团队协作，需要环境一致性和依赖锁定；
   • 频繁安装 / 更新依赖，追求开发效率；
   • 所有 venv 适用场景（uv 可无缝替代，且体验更优）。
3. 终极建议：可先通过 venv 理解虚拟环境的核心概念，掌握后立即切换到 uv——uv 完全兼容 venv 的操作逻辑，无需额外学习成本，却能带来性能和功能的双重提升，是现代 Python 开发的首选工具！