Ch22. Vim Packages
In the previous chapter, I mentioned using an external plugin manager to install plugins. Since version 8, Vim comes with its own built-in plugin manager called packages. In this chapter, you will learn how to use Vim packages to install plugins.
To see if your Vim build has the ability to use packages, run
:version and look for
+packages attribute. Alternatively, you can also run
:echo has('packages') (if it returns 1, then it has the packages ability).
Check if you have a
~/.vim/ directory in the root path. If you don't, create one. Inside it, create a directory called
~/.vim/pack/). Vim automatically knows to search inside this directory for packages.
Two Types Of Loading
Vim package has two loading mechanisms: automatic and manual loading.
To load plugins automatically when Vim starts, you need to put them in the
start/ directory. The path looks like this:
Now you may ask, "What is the
* is an arbitrary name and can be anything you want. let's name it
Keep in mind that if you skip it and do something like this instead:
The package system won't work. It is imperative to put a name between
For this demo, let's try to install the NERDTree plugin. Go all the way to the
start/ directory (
cd ~/.vim/pack/packdemo/start/) and clone the NERDTree repository:
git clone https://github.com/preservim/nerdtree.git
That's it! You are all set. The next time you start Vim, you can immediately execute NERDTree commands like
You can clone as many plugin repositories as you want inside the
~/.vim/pack/*/start/ path. Vim will automatically load each one. If you remove the cloned repository (
rm -rf nerdtree/), that plugin will not be available anymore.
To load plugins manually when Vim starts, you need to put them in the
opt/ directory. Similar to automatic loading, the path looks like this:
Let's use the same
packdemo/ directory from earlier:
This time, let's install the killersheep game (this requires Vim 8.2). Go to the
opt/ directory (
cd ~/.vim/pack/packdemo/opt/) and clone the repository:
git clone https://github.com/vim/killersheep.git
Start Vim. The command to execute the game is
:KillKillKill. Try running it. Vim will complain that it is not a valid editor command. You need to manually load the plugin first. Let's do that:
Now try running the command again
:KillKillKill. The command should work now.
You may wonder, "Why would I ever want to manually load packages? Isn't it better to automatically load everything at the start?"
Great question. Sometimes there are plugins that you won't use all the time, like that KillerSheep game. You probably don't need to load 10 different games and slow down Vim startup time. However, once in a while, when you are bored, you might want to play a few games. Use manual loading for nonessential plugins.
You can also use this to conditionally add plugins. Maybe you use both Neovim and Vim and there are plugins optimized for Neovim. You can add something like this in your vimrc:
if has('nvim')packadd! neovim-only-pluginelsepackadd! generic-vim-pluginendif
Recall that the requirement to use Vim's package system is to have either:
The fact that
* can be any name can be used to organize your packages. Suppose you want to group your plugins based on categories (colors, syntax, and games):
You can still use
opt/ inside each of the directories.
Adding Packages The Smart Way
You may wonder if Vim package will make popular plugin managers like vim-pathogen, vundle.vim, dein.vim, and vim-plug obsolete.
The answer is, as always, "it depends".
I still use vim-plug because it makes it easy to add, remove or update plugins. If you use many plugins, it may be more convenient to use plugin managers because it is easy to update many simultaneously. Some plugin managers also offer asynchronous functionalities.
If you are a minimalist, try out Vim packages. If you a heavy plugin user, you may want to consider using a plugin manager.Edit this page on GitHub