virtenv 0.3.1

Python API

create(python, env_dir, system, prompt, bare, virtualenv_py=None)

• python 应该是一个指向Python可执行文件的绝对路径。如果这不是 None，并且不匹配 sys.executable，则该解释器作为子进程启动以运行此脚本。否则，创建将在进程内完成（在创建过程中仍可能运行子进程）。

• env_dir 指向要创建新虚拟环境的目录。

• system 指定是否为创建的虚拟环境提供系统站点包。

• prompt 指定在创建的虚拟环境的激活脚本中使用的提示前缀。

• bare，如果为True，则阻止安装任何第三方库。这意味着您在创建的虚拟环境中不会有Setuptools、pip和Wheel。

• virtualenv_py 应该是一个指向 virtualenv.py 脚本的绝对路径。这是可选的；如果缺少，则不会使用virtualenv创建虚拟环境。

命令行API

virtenv env_dir --python PYTHON [--system] [--prompt PROMPT]

参数的含义与Python API类似。

必须指定python参数，可以是一个版本，例如3.7。如果可能，将自动查找合适的Python可执行文件。

何时使用venv

如上所述，如果可能，始终首选venv。以下场景使用virtualenv：

• 当目标Python中不存在模块venv时。

• 当目标Python中不存在模块ensurepip时。这通常发生在Python 3.3或Debian等不希望捆绑ensurepip的发行版。没有它，pip将不可用，我们不希望这样。

• 当设置sys.real_prefix时。这通常意味着目标Python由virtualenv管理，而venv在此情况下已知存在问题。更多信息请参见bpo-30811和pypa/virtualenv#1095的讨论。