Take the 2-minute tour ×
Super User is a question and answer site for computer enthusiasts and power users. It's 100% free, no registration required.

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,
 $VIMRUNTIME,
 $VIM:vimfiles:after"

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:

~/.vim/plugin.vim
~/.vim/vimfiles/plugin.vim
~/.vim/plugin/plugin.vim

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

share|improve this question
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

2 Answers 2

up vote 22 down vote accepted

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:

    ~/.vim/plugin/pluginname.vim
    

    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>
    ~/.vim/autoload/ctrlp/ctrlp.vim
    ~/.vim/doc/ctrlp.txt
    ~/.vim/plugin/ctrlp.vim
    
  5. Once you are OK with the basics of plugin management in Vim you should try Pathogen or Vundle or some other solution.

share|improve this answer
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/v‌​imfiles/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

share|improve this answer

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

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