virtualenv
PyPA 出品的 Python 虚拟环境创建工具,缓存预构建镜像让建环境不到 1 秒,并提供插件机制和完整 Python API,适合依赖 tox、virtualenvwrapper 工具链或在代码里调用环境创建的项目。
5 次可以打开平均 1.8 秒
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。virtualenv 用来创建隔离的 Python 环境:每个项目一套独立的解释器和依赖,装包、升级、删掉都只影响这个目录,不会污染系统 Python。Python 3.3 之后标准库自带了 venv 模块,virtualenv 的一部分能力被吸收进去,但它仍然独立发布,功能比 venv 多。
和 venv、uv 的区别
官方文档给了一张对比表。venv 最慢,创建环境要 60 秒以上,还要另起 pip 子进程装种子包;virtualenv 会缓存预构建的安装镜像,之后创建环境不到 1 秒;uv 用 Rust 实现,是毫秒级,但默认不装 pip 和 setuptools。venv 只能用当前运行它的那个 Python 版本,virtualenv 能自动发现机器上装着的各个 Python(注册表、uv 管理的、PATH 里的都算),uv 则管自己装的那部分。
扩展性上,venv 没有插件机制,virtualenv 有,可以自定义创建器、种子器和激活脚本;uv 也没有插件。virtualenv 还提供完整的 Python API,能在不真正创建环境的情况下描述环境,tox、poetry、pipx 都靠它工作。它带 PEP 561 的 py.typed 标记,类型注解完整。
适合谁
需要插件扩展、要在代码里调用环境创建、或者依赖 tox、virtualenvwrapper 这类工具链的项目,选 virtualenv 比较顺。只想要零依赖的基础隔离,标准库 venv 就够;已经在用 uv 管包、追求极致速度的,uv venv 更合适。
安装与文档
通过 PyPI 独立发布,升级节奏不跟 Python 版本绑定。文档分教程、操作指南、参考和原理说明几块,覆盖安装、选择 Python 版本、激活环境、命令行参数、环境目录结构、生成的配置文件,以及插件 API。相关项目里列了 virtualenvwrapper、pew、tox、nox 几个建立在它之上的工具。
