Сравнение текстов

Что делает этот инструмент

Дифф точно отвечает на один вопрос: что должно измениться, чтобы превратить один текст в другой? Вставьте оригинал в панель «Оригинал», а новую версию — в панель «Изменённый», и инструмент покажет каждую удалённую строку, каждую добавленную и — внутри изменённой строки — конкретные различающиеся слова с подсветкой. Это тот же вопрос, на который git отвечает при каждом коммите, вычисленный тем же семейством алгоритмов, целиком в вашем браузере.

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

Рядом или unified

Обе вид-формы показывают одно и то же сравнение, но в разной компоновке. Рядом ставит оригинал и изменённый текст друг напротив друга — колонка оригинала под панелью «Оригинал» — с выровненными совпадающими строками: естественный способ читать новую редакцию документа. Unified сплетает их в одну колонку: удаления с минусом в начале строки, добавления с плюсом — формат git log и код-ревью, компактнее и лучше, когда изменения разбросаны. Обе вид-формы показывают исходные номера строк на полях, так что находка здесь напрямую указывает на ваш файл.

Как вычисляется дифф

Инструмент реализует алгоритм различий Майерса, опубликованный в 1986 году и до сих пор используемый в git по умолчанию. Он находит кратчайший сценарий правок: минимальное число удалений и вставок строк, превращающее один текст в другой. Именно эта минимальность делает дифф читаемым — наивное сравнение, плохо синхронизирующееся после изменения, помечает целые блоки как заменённые, тогда как Майерс указывает ровно те две строки, которые действительно изменились.

Сначала сравниваются строки, затем каждая пара изменённых строк сравнивается ещё раз на уровне слов — так получается подсветка. Честное ограничение: когда у двух текстов почти нет общего, поиск минимального сценария стоил бы больше памяти, чем стоит тратить вкладке браузера, поэтому за пределами дистанции правок в две тысячи инструмент откатывается к показу всего как заменённого — и говорит об этом уведомлением, а не молча.

Настройки пробелов и регистра

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

• Игнорировать краевые пробелы — пробелы и табы в начале и конце каждой строки отбрасываются перед сравнением: изменение одних лишь отступов перестаёт выглядеть изменённой строкой. Пробелы внутри строки по-прежнему учитываются.
• Игнорировать регистр — строки и слова, различающиеся только регистром, считаются равными. Полезно для ключевых слов SQL, имён HTTP-заголовков и других нечувствительных к регистру контекстов.

Патч, который можно скопировать

Кнопка копирования выдаёт сравнение в формате unified diff — лингва франка изменений кода. Каждый блок изменений (hunk) начинается с заголовка @@ с номерами охваченных строк, удалённые строки начинаются с минуса, добавленные с плюса, а несколько неизменённых строк контекста окружают каждый блок, чтобы изменение можно было найти, даже если файл немного сместился.

--- a
+++ b
@@ -1,3 +1,3 @@
 server:
-  port: 8080
+  port: 9090
   timeout: 30

Этот текст можно вставить в тикет или код-ревью, отправить коллеге или применить механически: сохранённый в файл, git apply или юниксовая команда patch воспроизведут изменение на оригинале. Деталь, которую стоит знать: файл без завершающего перевода строки получает в патче маркер \ No newline at end of file — инструмент воспроизводит это поведение, потому что отсутствующий финальный перевод строки — настоящее различие, а притворяться иначе значит порождать патчи, которые не применяются.