vim-plug is known to work with Vim 7.0 or above, however 7.3+ is recommended.

Most of the features should work with Git 1.7 or above. However, installing plugins with tags is known to fail if Git is older than 1.7.10. Git 1.8 or greater is recommended.

Simply install neovim to make use of the job based installer.

vim-plug starts non-blocking, parallel installer on Vim 8. You can append --sync flag to PlugInstall or PlugUpdate command to make the installer block the control until completion.

If you use Vim 7, Ruby or Python is required to start parallel installer

The ruby installer requires the ruby interpreter (1.8.7+) and vim compiled with +ruby support.

You can check it works inside vim by:

:ruby puts 'ruby works'

The python installer requires python version >= 2.6 or any version of 3. Python 2.7 is recommended as many plugins still require +python. Vim must be compiled with +python or +python3.

To check the interfaces work:

• +python: :python print 'python 2 works'
• +python3: :python print('python 3 works')

On Windows the python installer works for GVim and terminal vim. Ruby is only available when using vim from terminal. The configurations below have been tested and work.

Install GVim, python and git. Ensure all are the same architecture 32 or 64 bit.

1. Install GVim for Windows, any version with +python or +python3 should do.

• Official GVim
• Community build, frequently updated to latest patch level.
• Any other version with +python should do.

1. Insall a matching python and put it on your PATH. I suggest Python 2.7.
2. Install git and put it on your PATH. I suggest Git For Windows.
   • If you use the portable version, remember to edit your PATH variable to make it available on the cmd prompt.
   • If you use the installer, select "Use Git from Windows Command Prompt".

Install msys2 then install the required packages. This will only allow you to use terminal vim.

1. Install msys2
2. Install the required packages from terminal.
3. Use ruby: pacman -S vim git ruby
4. Use python: pacman -S vim git python

Reminder: The ruby installer ONLY works from terminal.

OS X ships with Vim with Ruby support, so the parallel installer should work out of the box. Also, you can easily install the latest version of Vim using Homebrew.

If you use RVM and have issues, build Vim with system default Ruby.

rvm use system
brew reinstall vim

The default vim has support for both python and ruby installers. Just ensure you have all the required packages.

Ruby:

sudo apt-get install vim git ruby

Python:

sudo apt-get install vim git python

The default vim should work, just install any missing packages.

Ruby:

sudo pacman -S vim git ruby

Python:

sudo pacman -S vim git python

This step is a last resort, allowing you to build the requirements for vim-plug. You should use this if:

• Your version of python is too old.
• Your version of vim doesn't have +python or +python3.
• You just want a more recent version of one that isn't available from your package manager.

It should work on any POSIX machine with the required build-tools. Please change the dependencies line if your platform is not debian based. By default it will install into /usr/local, change DIR to install elsewhere.

#!/usr/bin/env bash

# This is where python & vim will be installed to.
DIR=/usr/local
PYTHON_URL=https://www.python.org/ftp/python/2.7.10/Python-2.7.10.tgz
NEED_SUDO=
if [[ "$DIR" ==  "/usr/local"* ]]; then
  NEED_SUDO=sudo
fi

# List of dependencies on Ubuntu, bare minimum excluding GTK/GNOME support
sudo apt-get install build-essential autoconf libncurses-dev curl git

# Build python 2.7, install to $DIR
curl $PYTHON_URL | tar -xz
cd Python*
./configure --prefix=$DIR
make
$NEED_SUDO make install
cd -
command rm -rf Python*

# Build vim with +python, install to $DIR
git clone --depth 1 https://github.com/vim/vim
cd vim
vi_cv_path_python=$DIR/bin/python ./configure --prefix=$DIR --with-features=huge --enable-pythoninterp
PATH=$DIR/bin:$PATH make
$NEED_SUDO make install
cd -
command rm -rf vim