Il comando git status fornisce una panoramica dello stato del repository, ma talvolta può risultare troppo generico: mostra quali file sono stati modificati, senza però evidenziare nel dettaglio quali righe siano cambiate.
Per ottenere una visione più approfondita delle differenze, è possibile utilizzare il comando git diff, che permette di ispezionare direttamente le modifiche a livello di contenuto.
- Quali modifiche sono state effettuate ma non ancora aggiunte all’area di staging?
- Quali modifiche risultano già presenti nello staging e che, di conseguenza, verranno incluse nel prossimo commit?
Differenze tra file modificati e staging area
Supponiamo, ad esempio, di modificare il file Readme.txt e di aggiungerlo allo staging con git add, mentre contestualmente modifichiamo il file Project1.cs senza però metterlo in staging.
Un comando git status restituirà un output simile a quello mostrato in FIG 1
 |
| FIG 1 - git status |
In questa situazione, se eseguiamo:
git diff
Git ci mostrerà le modifiche presenti nel working directory ma non ancora aggiunte allo staging. Questo output, detto patch, include esattamente le righe aggiunte (+) e rimosse (-) nei file.
 |
| FIG 2 - git diff |
Al contrario, se desideriamo visualizzare le differenze già pronte per il prossimo commit, dobbiamo usare:
git diff --staged
oppure, in alternativa:
git diff --cached
(--staged e --cached sono sinonimi). Questo comando confronta le modifiche presenti nello staging con l’ultimo commit registrato.
 |
| FIG 3 - git diff --staged |
Caso pratico: modifiche sia staged che unstaged
Può accadere che lo stesso file venga modificato, aggiunto allo staging e poi ulteriormente modificato senza essere riaggiunto. In questo caso, git diff e git diff --staged mostrano rispettivamente:
- le differenze non ancora aggiunte,
- le differenze già pronte per essere salvate nel commit successivo.
Questo scenario è comune durante lo sviluppo, e l’uso combinato dei due comandi consente di avere il massimo controllo su ciò che sarà effettivamente registrato nella cronologia del progetto.
Nota importante: È bene sottolineare che git diff, se usato da solo, non mostra tutte le modifiche rispetto all’ultimo commit, ma solo quelle ancora unstaged.
Se tutte le modifiche sono state aggiunte allo staging, il comando non produrrà alcun output. In questi casi, l’opzione --staged è necessaria per visualizzare le differenze.
Utilizzo di strumenti esterni: git difftool
Per chi preferisce un’interfaccia grafica o un visualizzatore esterno, Git mette a disposizione il comando git difftool. Questo consente di analizzare le differenze utilizzando software come vimdiff, meld, kdiff3, o strumenti commerciali come Beyond Compare e Araxis Merge.
 |
| FIG 4 - git difftool, richiesta avvio tool per la comparazione |
 |
| FIG 5 - Differenze nel file Project1.cs |
Per scoprire quali strumenti sono disponibili sul proprio sistema:
git difftool --tool-help
È possibile configurare uno strumento di default nel file di configurazione globale:
git config --global diff.tool meld
Da quel momento, eseguendo git difftool senza ulteriori opzioni, Git aprirà automaticamente le differenze nell’applicativo scelto.
Best practices
- Usare spesso git diff: controllare con regolarità le differenze riduce il rischio di commettere modifiche indesiderate.
- Verificare prima di committare: un git diff --staged prima di eseguire il commit assicura che solo le modifiche realmente volute vengano salvate nella cronologia.
- Configurare strumenti grafici: in progetti complessi, visualizzatori esterni possono facilitare l’analisi di modifiche estese.
Di seguito una tabella riepilogativa dei principali comandi di Git usati per analizzare lo stato dei file e le modifiche:
| Comando | Scopo principale | Cosa mostra | Quando usarlo | Output |
|---|---|---|---|---|
git status |
Fornisce una panoramica dello stato del repository | Elenco dei file modificati, non tracciati, staged o unstaged | Per avere una visione generale prima di committare | Testuale, descrittivo (ma non mostra le differenze riga per riga) |
git diff |
Mostra le modifiche non ancora aggiunte allo staging (unstaged) | Differenze tra working directory e staging area | Per sapere esattamente cosa è cambiato nei file non ancora aggiunti | Patch con righe aggiunte (+) e rimosse (-) |
git diff --staged (o git diff --cached) |
Mostra le modifiche già aggiunte allo staging | Differenze tra staging area e ultimo commit | Per verificare cosa verrà incluso nel prossimo commit | Patch dettagliata delle modifiche staged |
git difftool |
Visualizza le differenze con uno strumento esterno | Identico a git diff (staged o unstaged, a seconda dei parametri), ma in interfaccia grafica o editor |
Per analizzare modifiche complesse o in progetti estesi | Dipende dallo strumento scelto (es. vimdiff, meld, Beyond Compare, ecc.) |
