I had a real difficulty installing vim plugins on mac. I know for a plugin to be installed it has to be seen by runtimepath. According to vim docs, this is

 Macintosh: "$VIM:vimfiles,

First off, what does $VIM:vimfiles mean?? It is certainly not $VIM/vimfiles, as (~/.vim/vimfiles) does not work. So my options are

1) put my plugin in /usr/share/vim/vim73 (my $VIMRUNTIME, which i know to be BAD)

2) find a way to make vim look at my home directory when including plugins. I have putting my plugin in:


All to no avail. Can somebody help me out here? Thanks!

  • 1
    That runtimepath, as described in the docs, doesn't seem right for a Mac running OS X. I wonder if it refers only to the Mac OS that preceded OS X. Use this command to see what it really is on your machine: :set rtp?. My guess is that the runtimepath on your Mac is set as it would be for a Unix system, and that you should put your plugins in ~/.vim/plugin, not ~/.vim/vimfiles. – garyjohn Mar 25 '12 at 22:33
  • I recommend vim-plug. And for the record, in case you want to install a plugin globally for all users, see my answer here stackoverflow plugins globally – DrBeco Jul 10 '17 at 19:31

You don't need to do anything for Vim to find your plugins and settings. Except actually putting them in the right place.

  1. On UNIX derivatives, $VIM refers to the directory where Vim's support files were installed. On Mac OS X, a UNIX derivative, Vim's default location is /usr/bin and its support files are installed in /usr/share.

  2. Don't put your plugins/colorschemes/scripts in /usr/share/vim/vim73. Only default files should be there as they will likely be changed the next time you or Apple updates your install.

  3. On Mac OS X (or any UNIX derivative) you must put your plugins/colorschemes/scripts in a ~/.vim directory and your custom settings in a ~/.vimrc file. None of these are there by default: you'll have to create them yourself as well as any needed sub-directories.

  4. Some plugins consist of only one file, pluginname.vim that you should put in ~/.vim/plugin as in:


    If the plugin and your version of Vim are compatible it should work. Check the plugin's page if it needs some activation command or setting. You'll need to relaunch Vim anyway.

    Many plugins, though, are composed of many files in many directories like autoload, after, doc… You'll have to put the files in their corresponding directories under your ~/.vim, creating them as needed. Taking CtrlP as an example:

    ~/.vim/autoload/ctrlp/<many files>
  5. Once you are OK with the basics of plugin management in Vim you should try Pathogen or Vundle or some other solution.

  • 1
    I actually have my plugin in my ~/.vim folder and ~/.vim/plugin folder. when i run :scriptnames in vim, they never show up. What could be the issue? my vim installation must not be 'looking' in this directory... – Ying Mar 28 '12 at 11:10
  • The very first item in :set runtimepath? should be ~/.vim what is it? What plugin(s) are you trying to install? – romainl Mar 28 '12 at 11:54
  • Hmmm, this is the output. runtimepath=~/.vim,/usr/share/vim/vimfiles,/usr/share/vim/vim73,/usr/share/vim/vimfiles/after,~/.vim/after so it certainly seems right. im trying to install minibufexplorer – Ying Mar 28 '12 at 13:59
  • shoot...i know why. permissions were not right on the folder. The script is getting seen now! – Ying Mar 28 '12 at 14:05
  • You should investigate the issue: it's not normal that $ mkdir .vim creates a directory with wrong permissions. – romainl Mar 28 '12 at 14:33

Better use ~/.vim/plugin/ directory to put vim plugins files (as mentioned by Vim help command).

See http://www.youtube.com/watch?v=Dmv6-dguS3g&feature=player_embedded#!

In vim, see the help: :h plugin


Since this question not specifically about configuring paths in order to have plugins work, an alternative to mucking around with all the path stuff is to just source the specific plugins you want in vim from your .vimrc (assuming it's working) by adding the line :source PATH/TO/FILE.vim. Vim generally checks for .vimrc right in the home directory ~/. If it does not exist, try creating it there, and from within it either sourcing the plugin(s) you want as described, or first doing something else you'll notice when starting vim such as :echo your vimrc says hello.

  • I added "source: PATH_TO_FILE/plugin.vim". Now when I load any file in vim. I get this following error: "E172: Only one file name allowed: source: PATH_TO_FILE/plugin.vim" – yogeesh Apr 29 '16 at 4:57
  • @yogeesh You probably have spaces in the filename. In vim, you must delimit these using a backslash '\'. So, if your filename or path have spaces in them the line in your file will look more like :source /THE\ PATH/TO/MY\ FILE – Seldom 'Where's Monica' Needy Apr 29 '16 at 20:15
  • I figured out the problem. I was not aware of rtp! – yogeesh Apr 30 '16 at 15:46

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.