Through your coding career, you have likely had brief encounters with vi while looking over your coworker's shoulder or tweaking a server setup script. It looks arcane, and it's hard to tell if it's just an old habit of some coders or if it will actually make you more productive.
This guide is light on actual content and is intended to provide structure for how to learn vim. In truth, the only way to learn vim is to use it. The learning curve is steep but well worth it.
vim is versatile, and this guide is written from the perspective an engineer who (mostly):
- uses a Mac
sshinto Ubuntu virtual private servers (e.g. AWS EC2 instances)- writes Python/Django and JavaScript/React
- builds a web application
Hopefully this guide is applicable to others as well.
The basics of any text editor is being able to edit text, and vim is trickier than typing and deleting. There are plenty of cheatsheets and laundry lists of commands, so we won't add another here. The best way to learn it is to use vimtutor, a tutorial built into vim that you can launch from your console. Go through it first to learn the basics, then do it again in a week after using vim for real.
We maintain a 100 character line length in our codebase, which is less than half of the width of a 1920px screen. Typically, I keep 2 different windows open side-by-side. You can split your screen with :vsplit and switch back and forth with ctrl-w ctrl-w.
Search online for more split commands (there are a lot).
ctrl-p is your friend. When you're typing, you can autocomplete the current word, where the options are drawn from words found in all open buffers.
vimtutor should have gotten the basics of find/replace, but here are some particular helpful techniques I have found
# and * search for the word currently under your cursor.
- Vim Tips wiki - The "Details" section is pretty good
- Search and Replace on Multiple Files - This is really great technique for doing semi-automated renaming. For doing fully-automated renaming, I recommend using
sedor a shell script
vim is extremely deep because it is extremely customizable. This includes simple settings such as tab widths or case sensitivity in search, but it also includes syntax highlighting by file type and rich plugins.
My dotfiles are available on github to see my settings in my .vimrc. There are 2 semi-standard settings that have been tremendous for me personally:
imap jj <Esc>- Type 'jj' to exit insert mode. This saves the stretch for the escape key or for ctrl-{nnoremap ; :,nnoremap ; :- You type colon far more often than semi-colon, so this swaps those
Currently, I would recommend Vundle as your plugin manager.
Technically this is outside of vim, but I find screen to be indispensible in my environment. screen provides virtual shells so you can rapidly switch between vim and the shell. My typical setup has 3 screens:
- vim - I only have 1 instance of vim running at any time to avoid conflicts. I use multiple buffers and vim-session to maintain that
- shell - everything else I use outside of vim, including ack, git, scripts, file system management, etc.
- server - for web dev, you usually have to run a Django/Rails/Node development server, so I just keep that running in a separate shell
- Matt Cutts screen tutorial - the really, really short screen tutorial
- rackaid screen tutorial - the best screen tutorial I have found
Note that you can also create a .screenrc to customize your screens as well.
Macros allow you to record a series of commands and repeat them again. Very useful for repetitive tasks
- Vim Tips wiki
- rampion on how to edit multiple lines on StackOverflow - this isn't really a macro, but it's a very common pattern that I have used
Marks record your cursor position, which you can use as a "bookmark" or in combination with other commands. I usually use uppercase marks because I'm bouncing between so many files
Registers are basically a multi-clipboard. I like using registers when I am replacing repetitive code since the unnamed register keeps getting overwritten when I delete lines of code.
- Jim Dennis on grokking vi - a long but also deep StackOverflow answer on how vim works
- Vim Tips wiki - it's not very well-organized, but you will stumble across this site often while googling for vim tips
- Vim Awesome - index of vim plugins
- List of Django dev tools - for life outside of vim, here's a full stack of tools you can use for Django development
Although this guide is a quick read, learning to use vim can take a long time. While you are coding, be aware of the tasks at hand and keep that meta-awareness about what vim tricks you might use to be more efficient. Over time, more of it will become automatic, and everything will feel quick and intuitive.
Beyond this guide is a world of customizations and additional shortcuts to continue to learn.