virtualenvwrapper-win 1.2.7

安装

仅限Windows使用

要从任何目录使用这些脚本，请确保Python的Scripts子目录已在您的PATH中。例如，如果python安装在C:\Python27\，请确保C:\Python27\Scripts已在您的PATH中。

要安装，运行以下命令之一

# using pip
pip install virtualenvwrapper-win

# using easy_install
easy_install virtualenvwrapper-win

# from source
git clone git://github.com/davidmarble/virtualenvwrapper-win.git
cd virtualenvwrapper-win
python setup.py install   # or pip install .

主要命令

mkvirtualenv [mkvirtualenv-options] [virtualenv-options] <name>

创建一个名为<name>的新virtualenv环境。该环境将创建在WORKON_HOME中。

mkvirtualenv选项

-h

打印帮助文本。

-a project_path

将现有路径关联为项目目录

-i package

在新环境中安装包。此选项可重复使用以安装多个包。

-r requirements_file

requirements_file传递给pip install -r requirements_file

其他选项将传递给virtualenv命令。对于virtualenv的较新版本，-p / --python可以接受版本号而不是解释器完整路径，例如：mkvirtualenv -p3.5 <name>（假设您已安装Python 3.5.x解释器）。

lsvirtualenv

列出存储在WORKON_HOME中的所有环境。

rmvirtualenv <name>

删除名为<name>的环境。

workon [<name>]

如果指定了<name>，则激活名为<name>的环境（将工作虚拟环境更改为<name>）。如果已定义项目目录，我们将更改到它。如果没有指定参数，则列出可用的环境。可以在虚拟环境名称后传递额外的选项-c，以在未设置projectdir的情况下cd到虚拟环境目录。

deactivate

取消激活工作虚拟环境，并切换回默认系统Python。

add2virtualenv <full or relative path>

如果虚拟环境已经激活，将 <路径> 追加到环境 site-packages 下的 virtualenv_path_extensions.pth 文件中，这实际上将 <路径> 添加到环境的 PYTHONPATH 中。如果没有虚拟环境激活，将 <路径> 追加到默认 Python 的 site-packages 下的 virtualenv_path_extensions.pth 文件中。如果 <路径> 不存在，它将被创建。

便捷命令

cdproject

如果虚拟环境已激活并且已定义了项目目录，将当前工作目录更改为活动的虚拟环境的项目目录。使用 cd- 将返回到调用 cdproject 之前所在的最后一个目录。

cdsitepackages

如果虚拟环境已激活，将当前工作目录更改为活动的虚拟环境 site-packages 目录。如果没有虚拟环境激活，将当前工作目录更改为默认 Python 的 site-packages 目录。使用 cd- 将返回到调用 cdsitepackages 之前所在的最后一个目录。

cdvirtualenv

如果虚拟环境已激活，将当前工作目录更改为活动的虚拟环境的基本目录。如果没有虚拟环境激活，将当前工作目录更改为默认 Python 的基本目录。使用 cd- 将返回到调用 cdvirtualenv 之前所在的最后一个目录。

lssitepackages

如果虚拟环境已激活，列出该环境的 site-packages。如果没有虚拟环境激活，列出默认 Python 的 site-packages。输出包括 site-packages 目录的基本列表，easy-install.pth 的内容，以及 virtualenv_path_extensions.pth 的内容（由 add2virtualenv 使用）。

mkproject

如果设置了环境变量 PROJECT_HOME，将在 PROJECT_HOME 中创建一个新的项目目录并在 WORKON_HOME 中创建一个虚拟环境。项目路径将在创建时自动与虚拟环境关联。

setprojectdir <完整或相对路径>

如果虚拟环境已激活，将 <路径> 定义为包含源代码的项目目录。这允许使用 cdproject 来更改工作目录。此外，该目录将使用 add2virtualenv 添加到环境中。如果 <路径> 不存在，它将被创建。

toggleglobalsitepackages

如果虚拟环境已激活，在 PYTHONPATH 中包含全局 site-packages 或仅包含虚拟环境的 site-packages 之间切换。

whereis <文件>

一个用于便捷的脚本。返回包含可执行 文件 的位置（在 %PATH% 上）。你可以调用 whereis python 来查找以 python 开头的所有可执行文件，或调用 whereis python.exe 来进行完全匹配。

virtualenvwrapper

打印命令及其描述的基本帮助输出列表。（从 v.1.2.4 版本添加）

钩子

要在 mkvirtualenv 之后运行一些命令，可以使用钩子。首先，你需要定义 VIRTUALENVWRAPPER_HOOK_DIR 变量。如果设置了该变量，mkvirtualenv 将运行该目录中的 postmkvirtualenv.bat 脚本。

版本 <下一个>

版本 1.2.5

• 错误修复版本。

版本 1.2.4

• 修复了在 workon、rmvirtualenv、mkproject、mkvirtualenv -a 中虚拟环境名称或项目目录包含空格时的问题 (#89)。@thebjorn

• 修复了 add2virtualenv 和 setprojectdir 中的空格等问题 (#92, #93)。@thebjorn

• 添加了 mkproject 便捷脚本 (@thehug0naut)

• folder_delete.bat 已弃用，将在未来的版本中删除。你应该使用 rmdir %dirname% /s /q 来代替。

版本 1.2.3

• 修复了当 WORKON_HOME 文件夹包含空格时的问题。

• 修复了cmd.com无法将Python可执行文件传递给virtualenv的错误，如果路径包含驱动器字母。

• 改进了发布流程。

版本 1.2.2

• -a, -i和-r选项现在可用（@thebjorn）

• 添加了基本的测试套件（@thebjorn）

• 修复了rmvirtualenv命令，该命令在例如pip留下额外文件时未删除目录（@rcutmore）

版本 1.2.1

• 脚本现在保留在Scripts目录中（@adamc55）

版本 1.2.0（2015年3月16日）

感谢Christian Long (@christianmlong) * mkvirtualenv钩子