Справочник по Vim: Режим сверки отличий

СПРАВОЧНИК ПО VIM - Брам Мооленаар

В этом разделе рассматривается особенность +diff, которая позволяет показывать различия между двумя или тремя версиями одного и того же файла.

Основные сведения об этом режиме приводятся в разделе 08.7 Руководства пользователя.

1. Запуск режима сверки отличий
2. Просмотр различий
3. Перемещение между различиями
4. Копирование различий
5. Настройка режима сверки отличий

Vi не имеет такой возможности.

1. Запуск режима сверки отличий

Проще всего начать редактирование в режиме сверки отличий путём запуска Vim по команде "vimdiff". Эта команда запускает Vim, как обычно, но также включает несколько дополнительных настроек, предназначенных для просмотра различий между файлами в списке аргументов.

vimdiff файл1 файл2 [файл3 [файл4]]

Эта команда эквивалентна следующей:

vim -d файл1 файл2 [файл3 [файл4]]

Вы также можете использовать аналогичные команды для работы в графическом интерфейсе, а именно "gvimdiff" и "vim -d -g". Кроме того, возможно использование режима отображения различий только для просмотра - в этом случае Vim запускается по команде "viewdiff" или "gviewdiff". Для запуска в ограниченном режиме можно также использовать ключ командной строки "-r",  см. |-Z|.

Второй и последующие аргументы могут также быть именем каталога. В этом случае Vim самостоятельно добавит имя файла, указанное в первом аргументе к имени каталога, чтобы получить полное имя файла.

Эта возможность работает только в том случае, если на вашей системе доступна стандартная команда "diff". См. справку по опции 'diffexpr'.

При запуске в режиме сверки отличий Vim открывает отдельное окно для каждого файла, как при использовании ключа командной строки |-O|. При этом используется вертикальное разделение окон. Если вы предпочитаете разделение по горизонтали, то добавьте в командную строку ключ |-o|:

vimdiff -o файл1 файл2 [файл3]

Для каждого из файлов в списке аргументов настраиваются следующие значения опций:

Указанные опции настраиваются как местные по отношению к окну. При редактировании другого файла их значения сбрасываются к существующим глобальным значениям.

Показанные отличия на самом деле являются отличиями между буферами. Если вы внесёте изменения после загрузки файла, то они будут включены в отображаемые различия. Вам может потребоваться время от времени выполнять команду ":diffupdate", поскольку не все изменения приводят к немедленному обновлению различий на экране.

Вы можете указать в файле .vimrc определённые команды, которые должны выполняться только в режиме отображения различий. Это достигается с помощью следующей конструкции:

if &diff
   " настройки для режима отображения различий
else
   " настройки для обычного режима
endif

Если Vim уже запущен, то переход в режим отображения различий можно осуществить тремя способами.

Чтобы указанные команды использовали вертикальное разделение окон, применяйте их с командой |:vertical|. Например:

:vert diffsplit main.c~
:vert diffpatch /tmp/diff

Опция 'diff' может быть включена не более чем у четырёх буферов одновременно.

Поскольку значения опций запоминаются вместе с буфером, то вы можете перейти к редактированию какого-либо иного файла, и после возвращения к редактированию прежнего буфера снова использовать режим отображения различий. Чтобы отключить режим сверки отличий, достаточно просто отключить опцию 'diff' и, возможно, избавиться от колонки складок:

:set nodiff foldcolumn=0

2. Просмотр различий

В окнах, которые используют режим отображения различий, отображается текст, в котором подсвечиваются обнаруженные различия. При выполнении прокрутки текста опция 'scrollbind' заставляет также прокручиваться текст и в других окнах, использующих этот режим. Если вы используете вертикальное разделение окон, то текст в разных окнах должен правильно выравниваться относительно друг друга.

Выравнивание текста может быть нарушено в следующих случаях:

• при включённой опции 'wrap': некоторые длинные строки могут занимать экране две и более строк экрана;
• при открытии складок в одном окне, в то время как в других окнах складки остаются закрытыми;
• при выключенной опции 'scrollbind';
• при внесении изменений в текст;
• если в значении опции 'diffopt' отсутствует "filler", то при вставке или удалении строк выравнивание может быть нарушено.

Все буферы, которые редактировались в окне с включённой опцией 'diff' будут включены в набор файлов для просмотра различий. Это также касается и скрытых буферов - чтобы это было возможно, они должны быть загружены в такое окно перед скрытием.

Поскольку опция 'diff' является местной по отношению к окну, вы можете просматривать один и тот же буфер одновременно и в окне с включённым режимом просмотра отличий, и в обычном окне. Кроме того, вы можете просматривать изменения, внесённые в буфер, однако, поскольку Vim не может использовать два буфера для одного и того же файла, вам потребуется скопировать исходную версию файла и просматривать различия между отредактированным вариантом и этой копией. Например:

:!cp % tempfile
:diffsplit tempfile

Выгруженный из памяти буфер не может быть использован в режиме просмотра различий, однако вы вполне можете использовать скрытые буферы. Чтобы закрыть окно без выгрузки содержимого буфера из памяти, следует использовать команду ":hide".

Vim пытается обновлять различия при внесении изменений в текст, таких как вставка или удаление строк. Более сложные изменения и изменения внесённые в пределах одной строки могут не обновляться, но вы можете всегда сделать это вручную с помощью команды

:diffupdate

На месте строки, которая отсутствуют в одном окне, но присутствует в другом, Vim выводит "строку-заполнитель". Строка-заполнитель указывает, что в данном файле строка была удалена, либо соответствующая строка была добавлена в другом файле. Если вы не хотите использовать строку-заполнитель, то вам следует исключить "filler" из значения опции 'diffopt'.

Для скрытия текста, в котором не обнаружены изменения, используются складки.  Команды, позволяющие работать со складками, рассматриваются в разделе справочника |складки|.

Количество строк контекста вокруг различающихся строк, которые не прячутся в складки, может быть настроено с помощью опции 'diffopt'. Например, чтобы использовать 3 контекстных строки:

:set diffopt=filler,context:3

Различия подсвечиваются с помощью следующих групп подсветки:

3. Перемещение между различиями

Для перемещения между различиями используется две команды:

Если различие отсутствует и курсор не может быть перемещён, то подаётся звуковой сигнал об ошибке.

4. Копирование различий

Vim предлагает две команды для копирования текста из одного буфера в режиме просмотра различий в другой. В результате выполнения этих команд имеющиеся различия в заданном диапазоне будут сведены на нет.

Если [диапазон] не задан, то эти команды затрагивают различия, расположенные в позиции курсора или непосредственно перед ним. При использовании диапазона Vim пытается получить или передать только указанные строки. Это не всегда возможно, если в одном из буферов имеются удалённые строки.

Удалённые строки могут находиться в самом конце буфера, ниже последней строки. Если курсор находится в последней строке буфера и над этой строкой отсутствует различие, то команды ":diffget" и "do" получают соответствующие строки из другого буфера.

Для получения этих строк из другого буфера допускается использовать увеличенный на единицу номер последней строки. Например, для внесения всех изменений из другого буфера можно использовать следующую команду:

:1,$+1diffget

Обратите внимание, что хотя удалённые строки отображаются на экране, они не являются строками текста. Вы не можете, например, переместить курсор в такую строку. Чтобы заполнить удалённые строки строками из другого буфера, вам следует применить команду ":diffget" на строке, которая следует сразу после удалённых строк.

В качестве параметра "[буфер]" может выступать номер буфера, шаблон имени буфера или часть имени буфера. Приведём несколько примеров:

5. Настройка режима сверки отличий

См. также |'diffopt'| и справку по элементу "diff" опции 'fillchars'.

ОБНАРУЖЕНИЕ РАЗЛИЧИЙ

Для обнаружения различий можно использовать стандартную программу "diff", или какой-либо иной способ, для чего существует специальная опция 'diffexpr'. Опция 'diffexpr' применяется для настройки использования какой-либо другой программы сравнения файлов и обнаружения различий, отличной от стандартной программы "diff".

Если значение опции 'diffexpr' не задано, то Vim использует для обнаружения различий между файлами file1 и file2 следующую команду:

diff file1 file2 > outfile

Символ ">" заменяется в этой команде на значение опции 'shellredir'.

Вывод программы "diff" должен быть в обычном формате "ed". НЕ используйте так называемый "контекстный" формат различий. Формат, который понимает Vim выглядит, например, так:

1a2
> bbb
4d4
< 111
7c7
< GGG
---
> ggg

Здесь, "1a2" добавляет строку "bbb", "4d4" удаляет строку "111", а "7с7" заменяет строку "GGG" на "ggg".

Опция 'diffexpr' в качестве значения может иметь выражение, которое вычисляется Vim-ом для получения вышеуказанного формата описания различий.  При этом используются следующие переменные, значениями которых являются имена использованных файлов:

Кроме того, опция 'diffexpr' использует значения "icase" и "iwhite" в опции 'diffopt'. Выражение, заданное в опции 'diffexpr', не должно изменять значение опций 'lines' и 'columns'.

Пример (выполняется почти та же операция, что и при использовании пустой опции 'diffexpr'):

set diffexpr=MyDiff()
function MyDiff()
   let opt = ""
   if &diffopt =~ "icase"
     let opt = opt . "-i "
   endif
   if &diffopt =~ "iwhite"
     let opt = opt . "-b "
   endif
   silent execute "!diff -a --binary " . opt . v:fname_in . " " . 
        \ v:fname_new . " > " . v:fname_out
endfunction

Аргумент "-a" используется для того, чтобы обеспечить сравнение файлов в виде текста, поскольку сравнение файлов в бинарном виде не очень полезно. Аргумент "--binary" используется для чтения файлов в бинарном режиме, чтобы символ CTRL-Z не приводил к завершению текста при выполнении этого примера в DOS.

Vim выполняет проверку на правильность формата вывода программы обнаружения различий. Если Vim обнаружит, что используется неправильный формат, то выводится сообщение об ошибке. Возможные причины возникновения этой ошибки:

• Программа "diff" не может быть выполнена.
• Программа "diff" не создаёт файл различий в стандартном стиле "ed" (см. выше).
• Опция 'shell' и другие опции, связанные с настройкой оболочки, имеют неправильное значение. Проверьте, правильно ли выполняется обработка текста с использованием программ-фильтров, например с помощью команды ":!sort".
• Вы используете неработающее выражение в качестве значения опции 'diffexpr'.

Если причина появления ошибки не совсем ясна, то попробуйте включить опцию 'verbose', чтобы увидеть больше сообщений.

ИСПОЛЬЗОВАНИЕ ЗАПЛАТОК

Опция 'patchexpr' позволяет использовать для наложения заплаток выражение вместо стандартной программы "patch".

Если опция 'patchexpr' не задана, то Vim выполняет вызов стандартной программы "patch" следующим образом:

patch -o outfile origfile < patchfile

Это должно работать с подавляющим большинством версий программы "patch". Обратите внимание, что символ CR в середине строки может привести к проблемам, так как он воспринимается в качестве символа переноса строки.

Если вас не устраивает стандартное решение, то вы можете использовать для достижения той же цели собственное выражение, которое следует задавать в виде значения опции 'patchexpr'. При этом используются следующие переменные, значениями которых являются имена использованных файлов:

Пример (выполняются те же действия, то и при пустом значении опции 'patchexpr'):

let patchexpr=MyPatch
function MyPatch
   :call system("patch -o " . v:fname_out . " " . v:fname_in .
   \  " < " . v:fname_diff)
endfunction

Убедитесь, что при использовании программы "patch" не возникает нежелательных побочных эффектов. Следите за созданными дополнительно файлами, их следует удалять. Выражение должно применять заплатку к файлу и не делать ничего лишнего.

Vim меняет рабочий каталог на "/tmp" или какой-нибудь другой временный каталог перед тем, как начать вычисление выражения, заданного в значении опции 'patchexpr'. Это, по идее, должно предупредить применение заплатки к файлам в рабочем каталоге. Кроме того, Vim удаляет файлы, начинающиеся с имени в значении переменной v:fname_in и заканчивающиеся на ".rej" или ".orig".