Porównanie tekstów i Diff

Czym jest 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!

Kluczowe funkcje

Przykłady

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;

Jak korzystać

1. 1

   Wklej obie wersje

   Tekst oryginalny po lewej, zmieniony po prawej. Live diff renderuje się podczas pisania; duże wejścia (>200 KB łącznie) przełączają się na ręczny przycisk Diff.

2. 2

   Włącz potrzebne opcje ignorowania

   Ignoruj wielkość liter, wszystkie białe znaki, spacje końcowe lub puste wiersze — każda niezależna, pamiętana między wizytami.

3. 3

   Przeczytaj diff lub zabierz łatkę

   Side-by-Side do recenzji ludzkiej, Unified do formatu łatki `---/+++/@@`. „Kopiuj unified diff” wysyła czystą łatkę do schowka na potrzeby code review lub `patch -p1`.

Typowe pułapki 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="/pl/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

Typowe zastosowania

Snippet do code review

Wrzuć dwie wersje funkcji do pól, by zobaczyć zmianę nazwy, usuniętą gałąź lub nową klauzulę guard jednym spojrzeniem. Podświetlanie słów inline jest szybsze niż skanowanie diffu GitHub w poszukiwaniu jednoliniowej zmiany.

Redline umowy / polityki

Wklej wczorajszą umowę i dzisiejszą wersję. Wstawione klauzule wyskakują; niezmienione akapity przygasają do szarości. Eksportuj unified patch jako ślad recenzji prawnej.

Analiza osi czasu logów

Porównaj wycinek logów SRE sprzed incydentu z wycinkiem z trakcie incydentu. Dryf opóźnień, kodów statusu i częstotliwości wypływa natychmiast, bez `awk`.

Korekta prozy / wersji roboczej

Wklej wersję roboczą i wersję redaktora. Inline word diff pokazuje dokładnie, które zdania zostały przeredagowane — nieocenione przy akceptowaniu lub odrzucaniu zmian pojedynczo.

Recenzja tłumaczenia

Diffuj stare tłumaczenie z nowym, by potwierdzić, że nowa wersja zachowuje sens, strukturę i placeholdery. Włącz „Ignoruj spacje końcowe”, by wyciszyć szum, który tłumacze często wprowadzają.

Audyt plików konfiguracyjnych / .env

Porównaj dwa pliki `.env`, `docker-compose.yaml` lub shell rc. Z włączoną opcją „Ignoruj puste wiersze” diff skupia się na różnicach funkcjonalnych zamiast na szumie formatowania.

Szczegóły techniczne

LCS z obcinaniem prefiksu/sufiksu

Wspólne wiodące i końcowe wiersze są obcinane przed uruchomieniem programowania dynamicznego LCS. Diff „dwa configi po 2 000 wierszy z jednym zmienionym wierszem” zwija się do tabeli DP 1×1 i renderuje się w czasie krótszym niż milisekunda.

Diff intra-line na poziomie tokenów

Sąsiednie bloki usunięcia + dodania są parowane i tokenizowane po ciągach Unicode słów / nie-słów / białych znaków. Drugi przebieg LCS produkuje zielone/czerwone zakresy tokenów, które czynią zmodyfikowane wiersze czytelnymi.

Unified diff = zgodny z git/patch

Wyjście jest zgodne z formatem `---/+++/@@ -L,C +L,C @@` zdefiniowanym dla GNU patch i używanym przez Git, GitHub i każde narzędzie code review. Aplikuj przez `pbpaste | patch -p0`.

Limit wejścia 5 000 wierszy na stronę

Powyżej limitu diff jest obcinany i ostrzega. Dla wejść wielomegabajtowych użyj `diff -u` lub `git diff --no-index` z wiersza poleceń — strumieniują i obsługują gigabajty.

Najlepsze praktyki

Wybierz opcje ignorowania przed czytaniem

Szum od spacji końcowych, CRLF i wielkości liter zagłusza sygnał. Najpierw włącz odpowiednie opcje; diff czyta się znacznie łatwiej, a Ty nie uczysz się prześlizgiwać obok „fałszywych” zmian.

Unified do udostępniania, Side-by-Side do recenzji

Kolumny wizualne są dla Twoich oczu. Łatki unified są dla cudzych terminali. Skopiowany unified diff wpada bez tłumaczenia do wiadomości Slack, komentarza Jira lub `patch -p1`.

Sprawdzenie zdrowego rozsądku przez procent podobieństwa

Jeśli dwa pliki są „prawie takie same”, ale wynik podobieństwa to 30%, masz problem z zakończeniami wierszy lub białymi znakami. Włącz „Ignoruj wszystkie białe znaki” i sprawdź ponownie przed czytaniem diffu.

Często zadawane pytania