---

Ⅰ. 插件描述

Better Python virtual environments support for Vim

Ⅱ. 基本信息

创建日期：  2014-11-17 使用用户：  3 Github星：  0 插件作者：  Coacher

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'coacher/vim-virtualenv'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'coacher/vim-virtualenv'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'coacher/vim-virtualenv'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/coacher/vim-virtualenv

Ⅳ. 文档说明

vim-virtualenv

This Vim plugin provides a simple way to activate and deactivate Python virtual
environments created by the virtualenv
tool from a Vim session as well as synchronizes the Vim internal Python
sys.path variable with an already active virtual environment.

By default, :python and :python3 commands have access only to the
system-wide Python environment. vim-virtualenv changes the Vim internal Python
sys.path and environment $PATH and $PYTHONPATH variables so that they
refer to the chosen virtual environment, i.e. activates it.

However, :python and :python3 commands will be still tied to, respectively,
Python 2 and Python 3 versions that Vim was compiled against.

Note.
Since the v2.0.0 release there are no new features planned and there are no
known issues. Nevertheless this plugin is still maintained so feel free to file
a bug report or a feature request.

Key features

• Activate, deactivate and list virtualenvs from a Vim session.
  By default, vim-virtualenv works with virtualenvs located inside

g:virtualenv#directory to avoid unnecessary typing.

• When a Vim session is started inside an active virtualenv, vim-virtualenv
  synchronizes the Vim internal Python sys.path variable with the currently

active virtualenv.

• Activate virtualenvs by path using VirtualEnvActivate command.
  Paths can be absolute or relative, in the latter case they are first expanded

against g:virtualenv#directory and then against the current directory.

• Use <Tab> completion with VirtualEnvActivate and VirtualEnvList
  commands to avoid typing even more.
• Change the current directory to the directory of the currently active
  virtualenv using VirtualEnvCD command. By default, vim-virtualenv

automatically does this on virtualenv activation and returns back on
deactivation.

• This plugin is not a replacement for
  virtualenv or

virtualenvwrapper tools
nor it aims to be one.

Usage examples

List virtualenvs located inside g:virtualenv#directory:

:VirtualEnvList

List virtualenvs located inside the '/foo/bar' directory:

:VirtualEnvList /foo/bar

Activate the 'foo' virtualenv located inside g:virtualenv#directory:

:VirtualEnvActivate foo

Activate the virtualenv located at '/foo/bar/baz':

:VirtualEnvActivate /foo/bar/baz

Both VirtualEnvActivate and VirtualEnvList commands support <Tab>
completion.

Change the current directory to the currently active virtualenv directory:

:VirtualEnvCD

Deactivate the currently active virtualenv:

:VirtualEnvDeactivate

Name of the currently active virtualenv can be shown in the statusline via
virtualenv#statusline() function.

For a more detailed help see:

:help virtualenv