Guide galattiche per aspiranti programmatori

git diff è un comando Git multi-uso che permette di visualizzare le differenze tra due data source, che siano essi file, commit, branch oppure altro. In questa sezione vedremo gli utilizzi più tipici di git diff e illustreremo il formato standard con cui sono mostrate tali differenze.

Ecco un esempio pratico usando un repository creato da zero:

$ mkdir repo_for_diff
$ cd repo_for_diff
$ touch diff_test.txt
$ echo "this is a git diff test example" > diff_test.txt
$ git init
Initialized empty Git repository
$ git add diff_test.txt
$ git commit -m "add test file"
[master (root-commit) c5dfcdb] add test file
1 file changed, 1 insertion(+)
create mode 100644 diff_test.txt

Eseguendo ora git diff, non ci sarà alcun output, poiché non ci sono differenze tra il contenuto della working copy e l’ultimo commit (snapshot). Proviamo quindi a cambiare il contenuto del file tracciato nel repository:

$ echo "this is a diff example" > diff_test.txt
$ git diff
diff --git a/diff_test.txt b/diff_test.txt
index 6b0c6cf..b37e70a 100644
--- a/diff_test.txt
+++ b/diff_test.txt
@@ -1 +1 @@
-this is a git diff test example
+this is a diff example

Come leggere questo output?

• la prima riga mostra le data source che il comando git diff ha usato, a/diff_test.txt b/diff_test.txt (in questo caso l’ultimo snapshot del file e la versione nella working directory)
• la seconda riga mostra dei metadati interni di Git, in generale è una informazione che può essere ignorata
• la terza e quarta riga sono indicano la legenda dei due input di diff, serve per leggere la sezione successiva
• le ultime righe sono il “chunk” (o la lista dei chunk per quei due file) del diff, in cui nella pratica vengono mostrate solo le righe cambiate tra i file (con la legenda -/+ per indicare quale riga è presente in quale file); il chunk inizia con un head (la riga con @@, che indica un summary delle modifiche, in questo caso una riga cambiata)

NOTA nella vita reale, un chunk head potrebbe mostrare qualcosa tipo @@ -34,6 +34,8 @@ che significa “a partire dalla riga 34 del file, sono state rimosse 6 righe e aggiunte 8

Opzioni utili:

git diff

mostra le differenze tra l’attuale contenuto della working area e l’ultimo commit

git diff --staged

mostra le differenze tra l’attuale contenuto della staging area e l’ultimo commit

git diff ./path/to/file`

mostra le differenze solo per il file indicato

$ git log --pretty=oneline
957fbc92b123030c389bf8b4b874522bdf2db72c add feature
ce489262a1ee34340440e55a0b99ea6918e19e7a rename some classes
6b539f280d8b0ec4874671bae9c6bed80b788006 refactor some code for feature
646e7863348a427e1ed9163a9a96fa759112f102 add some copy to body
$ git diff 957fbc92b123030c389bf8b4b874522bdf2db72c ce489262a1ee34340440e55a0b99ea6918e19e7a

esegue il confronto tra due commit

git diff feature-branch..other-feature-branch

esegue il confronto tra due branch; in questo caso, vengono confrontati gli ultimi commit dei due branch (tip) avendo indicato l’operatore “doppio punto” (esistono altri “operatori punto” che permettono di eseguire diff diversi, per esempio con “…” viene confrontato l’ultimo commit comune tra i due branch e il tip del branch indicato a destra