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

Что такое Text Diff?

// Two strings that look 'mostly the same' but a naïve check disagrees
const a = 'hello world';
const b = 'hello, world!';

// Character equality
a === b; // false — but only 3 characters actually changed.

// LCS-style diff (this tool, at line + word granularity)
// → 1 line modified, inline highlight: 'hello[, ]world[!]'
// → unified patch:
//   --- original
//   +++ modified
//   @@ -1 +1 @@
//   -hello world
//   +hello, world!

Ключевые возможности

Примеры

function getUser(id) {
  const u = db.users.find(x => x.id === id);
  return u;
}

function getUser(userId) {
  const u = db.users.find(x => x.id === userId);
  return u;
}

1. The service is provided as-is.
2. Either party may terminate with 30 days notice.
3. Disputes are resolved in California courts.

1. The service is provided as-is.
2. Either party may terminate with 30 days notice.
2a. Termination notice must be in writing.
3. Disputes are resolved in California courts.

GET /api/users 200 14ms
POST /api/orders 201 88ms
GET /api/orders/42 200 21ms

GET /api/users 200 14ms
POST /api/orders 201 4200ms
GET /api/orders/42 500 21ms

  margin: 0;  
  padding: 0;
  border: none;

  margin: 0;
  padding: 0;
  border: none;

Как пользоваться

1. 1

   Вставьте обе версии

   Исходный текст слева, изменённый справа. Живой diff рендерится по мере ввода; при больших входах (>200 КБ суммарно) переключается на ручную кнопку Diff.

2. 2

   Включите нужные опции игнорирования

   Игнорировать регистр, все пробелы, конечные пробелы или пустые строки — каждая опция независима и сохраняется между визитами.

3. 3

   Читайте diff или забирайте патч

   Side-by-Side для человеческого ревью, Unified — для формата `---/+++/@@`. 'Скопировать unified diff' отправляет чистый патч в буфер обмена для code review или `patch -p1`.

Типичные ловушки diff

Diff: 200 modifications (all because of trailing \r)

Ignore trailing spaces / tabs → 2 real changes

Diff: 87 modifications (all are indent changes)

Ignore all whitespace → 4 actual changes

Diff: paragraph 2 'completely changed' (one blank line moved)

Ignore blank lines → no changes in paragraph 2

0 differences shown, but `cmp` says the files differ

Disable all Ignore options → real diff appears

Text diff on JSON: 100% of lines changed (just a key reorder)

<a href="/ru/tools/json-diff">JSON Diff</a>: 0 differences

Pasted a 20,000-line log — only first 5,000 lines diffed

`diff -u a.log b.log` in terminal handles full file

Частые сценарии

Сниппет для code review

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

Редлайн договора / политики

Вставьте вчерашний договор против сегодняшней редакции. Вставленные пункты выделяются; неизменённые абзацы уходят в серый. Экспортируйте unified-патч для юридического следа ревью.

Анализ таймлайна логов

Сравните срез лога SRE до инцидента со срезом во время инцидента. Дрейф латентности, статус-кодов и частоты всплывает сразу, без `awk`.

Ревизия прозы / черновика

Вставьте черновик и версию редактора. Пословный inline-diff показывает, какие именно предложения переписаны — незаменимо, чтобы принимать или отклонять правки по одной.

Ревью перевода

Сравните старый перевод с новым, чтобы подтвердить, что новый сохранил смысл, структуру и плейсхолдеры. Включите 'Игнорировать пробелы в конце строки', чтобы заглушить шум, который часто вносят переводчики.

Аудит файлов конфигов / .env

Сравните два файла `.env`, `docker-compose.yaml` или shell rc. С включённой опцией 'Игнорировать пустые строки' diff фокусируется на функциональных различиях, а не на форматной воде.

Технические детали

LCS с обрезкой префикса/суффикса

Общие начальные и конечные строки отсекаются до запуска динамического LCS. Diff 'два конфига по 2 000 строк с одной изменённой строкой' схлопывается до таблицы DP 1×1 и рендерится менее чем за миллисекунду.

Intra-line diff на уровне токенов

Соседние блоки удаления и добавления спариваются и токенизируются по последовательностям Unicode слов / не-слов / пробелов. Второй проход LCS даёт зелёные/красные диапазоны токенов, делающие изменённые строки читаемыми.

Unified diff = совместим с git/patch

Вывод следует формату `---/+++/@@ -L,C +L,C @@`, определённому для GNU patch и используемому Git, GitHub и любым инструментом code review. Применять через `pbpaste | patch -p0`.

Лимит входа — 5 000 строк на сторону

Выше лимита diff обрезается и предупреждает. Для входов в несколько мегабайт используйте `diff -u` или `git diff --no-index` в командной строке — они стримят и работают с гигабайтами.

Лучшие практики

Выбирайте опции игнорирования до чтения

Шум от пробелов в конце, CRLF и регистра заглушает сигнал. Сначала включите правильные опции; diff читается куда легче, и вы не привыкаете проскакивать 'ложные' изменения.

Unified — для отправки, Side-by-Side — для ревью

Визуальные колонки — для ваших глаз. Unified-патчи — для чужих терминалов. Скопированный unified diff без перевода ложится в сообщение Slack, комментарий Jira или `patch -p1`.

Проверка адекватности через процент сходства

Если два файла 'почти одинаковые', а сходство 30 %, у вас проблема с переводами строк или пробелами. Включите 'Игнорировать все пробелы' и проверьте снова, прежде чем читать diff.

Часто задаваемые вопросы