Your vimrc
file is an incredibly powerful, incredibly useful thing. Anything you can do in command-line mode you can do in your vimrc
file. This makes it possible to make settings (e.g. :set textwidth=80
) in the command-line mode and then make them permanent in your vimrc
file by just doing the exact same thing but in a file instead of in the running Vim session.
Where it is
Depending on what operating system you’re running on the vimrc
file will be in a slightly different place. However, no matter where it actually is you can reference it from within Vim using the$MYVIMRC
variable.
On Unix (Linux, OS X, whatever…)
On these operating systems, the vimrc
file defaults to being in your home directory at ~/.vimrc
. If it’s not there then just create it by editing it and saving it.
On Microsoft Windows
On all of the MS Windows variants you’ll also find this in your HOME Directory but most people don’t know where that is ;). I’m not going to try and tell you where it is, specifically and leave that up toWikipedia’s Home Directory Page. In general however it is one directory up from the directory that contains your “Documents” (e.g. “My Documents” in Windows XP). The major difference is that it’snamed slightly differently than it is in Unix: it’s named _vimrc.
What’s it for?
Everything. Ok, that’s not strictly true but at this stage in the game it’s more than sufficient to look at it that way. In practice you’ll find that plugins and many other types of file type specificconfiguration will make use of Vim’s extensive capabilities in its runtime structure, outside of thevimrc
file but that sort of thing comes… later.
Generally you should think of your vimrc
file as holding your own personal option settings,mappings, functions, commands and whatever else you need to customize Vim for your personal use.
Short example:
Make Vi-Vim never use tabs (converting spaces to tabs, bad!), makes the tab key == 4 spaces, and automatically indent code after curly brace blocks
set smartindentset tabstop=4set shiftwidth=4set expandtab
The help files take a bit of time to get used to but the more you read the better vim gets:
:help smartindent
Even better, you can embed these settings in your source for portability:
:help auto-setting
To see your current settings:
:set all
use the smartindent format
:set
smartindent