In my case, I have two files file1 and file2. Using vimdiff, I want to merge the changes as follows:
You can just switch between the windows and copy and paste to resolve the differences, as @David W. suggests in his answer, but Vim also has dedicated :diffput
and :diffget
commands to simplify this. With these (or the corresponding normal mode do
and dp
commands), you don't have to switch between windows, and the range defaults to the current change.
If you need to add instead of overwrite with the other buffer's differences (which is a rather unusual case in a classic two-way diff), you still have to yank the original lines and put them after the :diffget
.
After you're done in one place, you can use the ]c
, [c
commands to jump to the next difference.
You can switch back and forth between the two windows with Ctrlww. You can copy from one window do a Ctrlww, and then paste into the other. As you resolve differences, the highlights will change, and disappear.
Take a look at this video.
You can use the following basic commands to merge:
do - Get changes from other window into the current window.
dp - Put the changes from current window into the other window.
]c - Jump to the next change.
[c - Jump to the previous change.
zo - Open folded lines.
zc - Close folded lines.
zr - Unfold both files completely.
zm - Fold both files completely.
Ctrlww - change window.
:only | wq
- quit other windows, write and quit.
Both do and dp work if you are on a block of change (or just one line under a single line of change) in Normal mode, but not in Visual mode.
The undo command will only work in the buffer that was changed, so if you use dp and change your mind, you need to switch to the other buffer to undo.
:diffupdate
will re-scan the files for changes (Vim can get confused, and show bogus stuff).
When selecting lines of text in Visual mode, you must use the normal commands:
:'<,'>diffget
and:'<,'>diffput
.For example:
:diffput
to push the selected lines to the other file or :diffget
to get the selected lines from the other file.To belabor the point: This means that if there is a block of changes consisting of multiple lines, then selecting a subset of lines and issueing :diffput
will only apply those changes in the other buffer.
(:diffget
and :diffput
also accept ranges, see :h copy-diffs
for more.)
If you load up two files in splits (:vs
or :sp
), you can do :diffthis
on each window and achieve a diff of files that were already loaded in buffers.
:diffoff
can be used to turn off the diff mode.
This Vimcasts post and video show this in practice.
Make sure that all participating buffers are in diff mode (see :h start-vimdiff
)
a. Get changes from a buffer to the current one:
:%diffget <buffer-number>
b. Put all changes from current buffer into another:
:%diffput <buffer-number>
(:%
is a range to select the entire file; see :h :%
. :ls
will show currently opened buffers.)