83

Is it possible to view two files side-by-side in Vim? If so, how can I set up my editor to do this, and is there a way to diff between the two files within Vim?

I am aware of the :next and :prev commands, but this is not what I'm after. It would really be nice to view the two files in tandem.

66

Open the side by side view:

Ctrl+w v

Change between them:

Ctrl+w h or l

Checkout the vimdiff command, part of the vim package, if you want a diff-like view:

vimdiff file1.txt file2.txt
4
59

You can also open vim in split-screen mode, with the -O option:-

vim -O file1 [file2 ...]

To then turn on diff mode, you need to run the :diffthis command in each pane.

Another use-case scenario, is if you've already got one file open in vim, and you want to open and compare it against another. Then you can use the following vim commands:-

:vs otherfile (open otherfile in vertical split screen)
:diffthis (turn on diff mode in original file)
Ctrl+w l  (swap to newly opened file)
:diffthis (turn on diff mode in opened file)

You can then turn off diff mode in each pane with the vim command :diffoff.

EDIT
And the other standard one that hasn't been mentioned:-

vim -d file1 [file2 ...]

This is equivalent to calling vimdiff directly.

1
  • 17
    :windo :diffthis can be used instead of the last three commands.
    – Bernhard
    Oct 24 '12 at 11:12
16

Or just open the first file in VIM, then :vert diffsplit file2 :vert makes it split the screen vertically.

diffsplit does a diff, and splits the files and scrolls locks them.

2
  • Quick and simple! And works without issues when you already have vim opened. Should be the accepted answer!
    – Sheharyar
    Jul 22 '20 at 14:34
  • diffsplit can be abbreviated, so :vert diffs file2 is sufficient.
    – Wolfson
    Oct 5 '20 at 12:36
2

While it has already been answered how to start the diff, it's also important how to stop it in all windows. For completeness, I repeat the comment from @Bernhard.

Start and Stop Diff of two files opened in 2 Windows (works in both, vertical and horizontal split):

:windo diffthis
:windo diffoff

this can be shortened to either

:windo difft
:windo diffo

or

:windo difft
:diffo!

Be aware that opened windows for showing plugin content lead to issues. So close stuff like NERDtree, minibufexplorer++ etc before.

Custom commands: To ease up things you can add custom commands to your ~/.vimrc:

command! Difft [ClosePluginWindow |] windo diffthis
command! Diffo windo diffoff

with [ClosePluginWindow |] being optional to close plugin windows you usually use. For NERDtree e.g. this would be NERDTreeClose |.

Credits go to @cxw and @Jordi Freixa.

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.