Confronta testi / diff checker

Cos'è un diff checker?

Un diff checker confronta due testi o due porzioni di codice ed evidenzia cosa è stato aggiunto, rimosso o modificato. Gli sviluppatori usano i diff di continuo: per revisionare codice, fare debug di modifiche alla configurazione, confrontare risposte di API, validare migrazioni e capire le modifiche prima di fare commit.

Saper leggere un diff è una competenza fondamentale per chi sviluppa. Ti aiuta a separare i *veri cambi di comportamento* dalle semplici riformattazioni e a trovare l'unico carattere modificato in un blocco di 200 righe. Una volta interiorizzato il ritmo verde / rosso / giallo, la code review diventa molto più veloce.

I tipi di diff più importanti sono due: il *diff per riga* (quali righe sono cambiate) e il *diff per parola* o *per carattere* (cosa è cambiato all'interno di una riga). Un buon strumento di diff ti permette di passare dall'uno all'altro a seconda che tu stia confrontando codice sorgente o paragrafi di testo.

Cosa imparerai confrontando testi

• I diff per riga mostrano *dove* sono avvenute le modifiche. I diff per parola e per carattere mostrano *cosa* è cambiato all'interno di una riga.
• Gli spazi possono essere significativi (Markdown, YAML, Python) o irrilevanti (quasi tutto il resto del codice): attiva o disattiva l'opzione per ignorarli di conseguenza.
• Un diff che sembra piccolo può avere un impatto enorme se cambia un valore, una condizione, una route, una variabile d'ambiente o un feature flag.
• Quando due blocchi grandi sono molto diversi, ordinali o normalizzali prima: confrontare due oggetti JSON non ordinati può produrre un muro di falsi positivi.

Come confrontare due testi passo dopo passo

1. 1

   Incolla le due versioni

   Metti il testo originale a sinistra e la nuova versione a destra. Codice, JSON, testo semplice, file di configurazione: va bene qualsiasi cosa.

2. 2

   Scegli diff per riga o per parola

   Usa il diff per riga per il codice sorgente o i dati strutturati. Passa al diff per parola quando confronti paragrafi di testo in cui conta la scelta delle parole.

3. 3

   Gestisci spazi e maiuscole

   Attiva *ignora spazi* se ti interessano solo le modifiche significative; attiva *ignora maiuscole* quando confronti log o testi in cui maiuscole e minuscole sono casuali.

4. 4

   Leggi l'output colorato

   Il contenuto rimosso compare in rosso a sinistra, quello aggiunto in verde a destra. Le righe modificate spesso compaiono come una di ciascun tipo, affiancate.

5. 5

   Ripeti

   Modifica uno dei due lati e guarda il diff aggiornarsi in tempo reale. È perfetto per preparare una patch pulita prima di aprire una pull request.

Riferimento rapido di colori e simboli del diff

Le convenzioni usate dal diff checker di Coddy, e anche da git diff, GitHub e dalla maggior parte degli altri visualizzatori di diff.

Esempi di diff da provare

API_TIMEOUT=3000

API_TIMEOUT=30000

{  "id": 42,  "status": "draft",  "published": false}

{  "id": 42,  "status": "published",  "published": true}

function total(items) {  let sum = 0;  for (const i of items) sum += i.price;  return sum;}

function total(items) {  return items.reduce((sum, i) => sum + i.price, 0);}

@@ -1,4 +1,4 @@ function greet(name) {-  return 'Hi ' + name;+  return `Hi ${name}`; }

Errori comuni con i diff

• Ignorare gli spazi quando sono significativi: Markdown, YAML e Python tengono tutti all'indentazione.
• Guardare solo le righe verdi (aggiunte) e perdere righe rosse (eliminate) importanti.
• Pensare che un diff pulito dimostri che la nuova versione è corretta. Un diff mostra solo *cosa è cambiato*, non *se la modifica è giusta*.
• Confrontare JSON minificato con codice formattato senza prima normalizzare uno dei due input: ogni riga sembrerà diversa anche se i dati sono gli stessi.
• Fidarsi di un diff affiancato per file molto lunghi senza cercare parole chiave specifiche. Usa entrambe le cose: prima scorri, poi Ctrl+F per il campo che ti interessa.

Domande frequenti sul Diff Checker