virtualenv 与虚拟环境

定义

虚拟环境(virtual environment)是 Python 的依赖隔离机制:为每个项目创建一份独立的解释器入口与 site-packages 目录,使不同项目可以使用互不冲突的包版本。virtualenv 是实现该机制的第三方先驱工具,Python 3.3 起标准库内置了简化版 venv 模块。

原理

创建虚拟环境时,工具在目标目录生成 python 可执行文件(或符号链接)、pyvenv.cfg 配置与空的 site-packages;激活脚本(activate)将该目录前置到 PATH,使 pip 安装的包只落入本环境,不污染系统 Python。

用法

python -m venv .venv 创建,source .venv/bin/activate 激活;virtualenv 相比 venv 速度更快、支持指定任意版本解释器。

生态

conda、Poetry、Pipenv、uv 等工具都在虚拟环境概念上构建;"一个项目一个环境"已成为 Python 工程的基本纪律,是解决"依赖地狱"的第一道防线。