Buffers, Windows, and Tabs
Buffers, Windows, and Tabs
If you have used a modern text editor, you are probably familiar with windows and tabs. Vim uses three display abstractions instead of two: buffers, windows, and tabs. In this chapter, I will explain what buffers, windows, and tabs are and how they work in Vim.
Before you start, make sure you have the
set hidden option in vimrc. Without it, whenever you switch buffers and your current buffer is not saved, Vim will prompt you to save the file (you don't want that if you want to move quickly). I haven't cover vimrc yet. If you don't have a vimrc, create one. It is usually placed at the root directory and named
.vimrc. I have mine on
~/.vimrc. To see where you should create your vimrc, check out
:h vimrc. Inside it, add:
Save it, then source it (run
:source % from inside the vimrc).
What is a buffer?
A buffer is an in-memory space where you can write and edit some text. When you open a file in Vim, the data is bound to a buffer. When you open 3 files in Vim, you have 3 buffers.
Have two empty files,
file2.js available (if possible, create them with Vim). Run this in the terminal:
What you are seeing is
file1.js buffer. Whenever you open a new file, Vim creates a new buffer.
Exit Vim. This time, open two new files:
vim file1.js file2.js
Vim currently displays
file1.js buffer, but it actually creates two buffers:
file1.js buffer and
file2.js buffer. Run
:buffers to see all the buffers (alternatively, you can use
:files too). You should see both
file2.js listed. Running
vim file1 file2 file3 ... filen creates n amount of buffers. Each time you open a new file, Vim create a new buffer for that file.
There are several ways you can traverse buffers:
:bnextto go to the next buffer (
:bpreviousto go to the previous buffer).
:buffer+ filename. Vim can autocomplete filename with
nis the buffer number. For example, typing
:buffer 2will take you to buffer #2.
- Jump to the older position in jump list with
Ctrl-Oand to the newer position with
Ctrl-I. These are not buffer specific methods, but they can be used to jump between different buffers. I will talk more about jumps in Chapter 5.
- Go to the previously edited buffer with
Once Vim creates a buffer, it will remain in your buffers list. To remove it, you can type
:bdelete. It accepts either a buffer number (
:bdelete 3 to delete buffer #3) or a filename (
:bdelete then use
<Tab> to autocomplete).
The hardest thing for me when learning about buffer was visualizing how it worked because my mind was used to windows from when using a mainstream text editor. A good analogy is a deck of playing cards. If I have 2 buffers, I have a stack of 2 cards. The card on top is the only card I see, but I know there are card(s) below it. If I see
file1.js buffer displayed then the
file1.js card is on the top of the deck. I can't see the other card, the
file2.js, but it's there. If I switch buffers to
file2.js card is now on the top of the deck and
file1.js card is at the bottom.
If you haven't used Vim before, this is a new concept. Take your time to understand it.
By the way, if you have multiple buffers opened, you can close all of them with quit-all:
If you want to close without saving your changes, just add
! at the end:
To save and quit all, run:
A window is a viewport on a buffer. If you're coming from a mainstream editor, this concept may be familiar to you. Most text editors have the ability to display multiple windows. In Vim, you can also have multiple windows.
file1.js from the terminal again:
Earlier I said that you're looking at
file1.js buffer. While that was correct, that statement was incomplete. You are looking at
file1.js buffer displayed through a window. A window is what you are seeing a buffer through.
Don't quit Vim yet. Run:
Now you are looking at two buffers through two windows. The top window displays
file2.js buffer. The bottom window displays
If you want to navigate between windows, use these shortcuts:
Ctrl-W H Moves the cursor to the left windowCtrl-W J Moves the cursor to the window belowCtrl-W K Moves the cursor to the window upperCtrl-W L Moves the cursor to the right window
You are now seeing three windows displaying three buffers. One window displays
file3.js buffer, another window displays
file2.js buffer, and another window displays
You can have multiple windows displaying the same buffer. While you're on the top left window, type:
Now both two windows are displaying
file2.js buffer. If you start typing on a
file2.js window, you will see that both windows that display
file2.js buffers are being updated in real-time.
To close the current window, you can run
Ctrl-W C or type
:quit. When you close a window, the buffer will still be there (run
:buffers to confirm this).
Here are some useful normal-mode window commands:
Ctrl-W V Opens a new vertical splitCtrl-W S Opens a new horizontal splitCtrl-W C Closes a windowCtrl-W O Makes the current window the only one on screen and closes other windows
And here is a list of useful window command-line commands:
:vsplit filename Split window vertically:split filename Split window horizontally:new filename Create new window
Take your time to understand them. For more, check out
A tab is a collection of windows. Think of it like a layout for windows. In most modern text editors (and modern internet browsers), a tab means an open file / page and when you close it, that file / page goes away. In Vim, a tab does not represent an open file. When you close a tab in Vim, you are not closing a file. You are only closing the layout. The data for those files are stored in-memory in buffers. The buffers are still there.
Let's see Vim tabs in action. Open
file2.js in a new tab:
You can also let Vim autocomplete the file you want to open in a new tab by pressing
<Tab> (no pun intended).
Below is a list of useful tab navigations:
:tabnew file.txt Open file.txt in a new tab:tabclose Close the current tab:tabnext Go to next tab:tabprevious Go to previous tab:tablast Go to last tab:tabfirst Go to first tab
You can also run
gt to go to next tab page (you can go to previous tab with
gT). You can pass count as argument to
gt, where count is tab number. To go to the third tab, do
One advantage of having multiple tabs is you can have different window arrangements in different tabs. Maybe you want your first tab to have 3 vertical windows and second tab to have a mixed horizontal and vertical windows layout. Tab is the perfect tool for the job!
To start Vim with multiple tabs, you can do this from the terminal:
vim -p file1.js file2.js file3.js
Moving between windows is like traveling two-dimensionally along X-Y axis in a Cartesian coordinate. You can move to the top, right, bottom, and left window with
Moving between buffers is like traveling across the Z axis in a Cartesian coordinate. Imagine your buffer files lining up across the Z axis. You can traverse the Z axis one buffer at a time with
:bprevious. You can jump to any coordinate in Z axis with
You can move in three-dimensional space by combining window and buffer movements. You can move to the top, right, bottom, or left window (X-Y navigations) with window navigations. Since each window contains buffers, you can move forward and backward (Z navigations) with buffer movements.
You have learned what buffers, windows, and tabs are and how they work in Vim. Now that you understand them better, you can use them in your own workflow.
Everyone has a different workflow, here is mine for example:
- First I use buffers to store all the required files for the current task. Vim can handle many open buffers before it starts slowing down. Plus having many buffers opened won't crowd my screen. I am only seeing one buffer (assuming I have only one window) at any time, allowing me to focus on one screen. When I need to go somewhere, I can quickly fly to any open buffer anytime.
- I use multiple windows to view multiple buffers at once, usually when diffing files, reading docs, or following a code flow. I try to keep the number of windows opened to no more than three because my screen will get crowded (I use a small laptop). When I am done, I close any extra windows. Fewer windows means less distractions.
- Instead of tabs, I use tmux windows. I usually use multiple tmux windows at once. For example, one tmux window for client-side codes and another for backend codes.
My workflow may look different than yours based on your editing style and that's fine. Experiment around to discover your own flow suited for your coding style.Edit this page on GitHub