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

不同系统操作：

示例（Linux/macOS）：

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

3. 激活虚拟环境 激活后，终端会显示虚拟环境名称前缀（如 (my_project_venv)），此时通过 pip 安装的依赖会仅存于该环境（继承模式下，新增依赖仍安装在虚拟环境内，不影响系统全局）。

不同系统激活命令：

激活成功标识：终端前缀会新增(环境名)，例如：

• Linux/macOS：(my_project_venv_with_global) user@localhost:~$
• Windows：(my_project_venv_with_global) C:\Users\XXX\>

验证激活状态（可选）：

# 查看当前 Python 路径（指向虚拟环境内的 Python 解释器）
which python3 # Linux/macOS
where python # Windows
# 查看当前 pip 路径（指向虚拟环境内的 pip）
which pip3 # Linux/macOS
where pip # Windows
# 验证继承的系统包（继承模式下执行，可看到系统全局安装的包）
pip list # 列出虚拟环境中的所有包（含继承的系统包和后续安装的包）

4. 退出虚拟环境 命令（所有系统通用）：在已激活虚拟环境的终端中，直接输入以下命令，无需额外参数：

deactivate

退出成功标识：终端前缀的(环境名)消失，恢复到系统默认终端样式，此时操作会回到系统全局 Python 环境。

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

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 倍。

三、venv vs uv 核心对比表

四、最终选型建议

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