Il giro di ogni giorno
Guarda, scegli, scatta
- 10 minuti di lettura
Nel capitolo precedente hai visto cosa c'è dentro Git: fotografie (i commit) legate l'una all'altra. Adesso impari a scattarle.
Quasi tutto il lavoro con Git è sempre lo stesso giro, tutti i giorni:
- guardi cosa è cambiato (
git status,git diff); - scegli cosa mettere nella prossima foto (
git add); - scatti (
git commit).
Pochi comandi, più due per rimediare agli errori: git restore e git restore --staged.
I quattro posti
Un file, prima di entrare nell'album, passa da tre posti. Uno lo conosci già: è la cartella dove lavori.
SCRIVANIA ──── git add ────▶ SET ──── git commit ────▶ ALBUM ──── git push ────▶ ALBUM ONLINE
◀── git restore --staged ── (le foto scattate) (capitolo 5)| Posto | Cos'è | Come lo guardi |
|---|---|---|
| Scrivania | I tuoi file, come sono adesso. Li modifichi con VS Code | git diff |
| Set | Quello che entrerà nella prossima foto | git diff --staged |
| Album | Le foto già scattate, sul tuo computer | git log |
| Album online | La copia su GitHub. Per ora solo il nome: ci arriviamo nel capitolo 5 | — |
Il set esiste per un motivo: ti permette di scegliere. Hai cambiato tre file ma ne vuoi fotografare uno? Metti sul set solo quello.
Il set si chiama anche staging area (staged vuol dire «sul set»): lo troverai scritto così nei messaggi di Git.
git status: la bussola
git status ti dice dove sta ogni file. Lancialo prima e dopo ogni comando: è gratis, e non cambia niente.
Questo è il tabellone di Lucia con tre cose in corso: orari.txt è già sul set, fermate.txt è modificato solo sulla scrivania, bozza-avvisi.txt è un file nuovo.
On branch main
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: orari.txt
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: fermate.txt
Untracked files:
(use "git add <file>..." to include in what will be committed)
bozza-avvisi.txtTre blocchi, tre posti:
| Il blocco dice | Vuol dire | Dov'è il file |
|---|---|---|
Changes to be committed | Entrerà nella prossima foto | Sul set |
Changes not staged for commit | Già nell'album, ma cambiato: non entrerà | Sulla scrivania |
Untracked files | Un file nuovo che Git non conosce | Sulla scrivania, mai fotografato |
E le righe tra parentesi? Sono i suggerimenti di Git: ti dicono già il comando per spostare il file. Leggile.
I file Untracked possono restare dove sono: se non li metti sul set, non entrano mai nell'album. Come non vederli più in git status lo impari nel capitolo 6.
Una cartella nuova: git init
Per far seguire a Git una cartella che non è ancora un repository, lo scrivi una volta sola, dentro la cartella:
git init -b mainInitialized empty Git repository in /private/tmp/tu/smarriti/.git/(Il percorso sarà il tuo.) Nasce la cartella nascosta .git: è l'album. -b main dà il nome main al branch.
git add: scegli cosa fotografare
git add orari.txt # un file
git add orari.txt fermate.txt # due file
git add . # tutto quello che è cambiato, in questa cartella
git add -p orari.txt # un pezzo alla voltagit add . è comodo ma non sceglie: mette sul set tutto, anche la bozza a metà e il file che non doveva uscire. Guarda sempre git status prima.
git add -p (p come patch, «pezzo») fa vedere le modifiche un pezzo alla volta, e per ogni pezzo chiede cosa fare:
| Tasto | Cosa fa |
|---|---|
y | Sì: questo pezzo va sul set |
n | No: questo pezzo resta sulla scrivania |
s | Spezza il pezzo in pezzi più piccoli (se ci sono righe invariate in mezzo) |
q | Basta: esci, quello che hai già scelto resta sul set |
Serve quando in un file hai fatto due cose diverse e vuoi due foto diverse.
git commit: scatta
git commit -m "Aggiunge la corsa delle 6:36"[main 00d5f85] Aggiunge la corsa delle 6:36
1 file changed, 1 insertion(+)Il commit fotografa quello che è sul set, non quello che è sulla scrivania. 00d5f85 è il codice della foto: i tuoi codici saranno diversi, perché dipendono da chi sei e da quando scatti.
Il messaggio, dopo -m, tra virgolette. Un buon messaggio dice cosa fa il commit, come se completasse la frase «questo commit…»:
| Così sì | Così no |
|---|---|
Aggiunge la corsa delle 6:36 | modifiche |
Corregge l'orario del M14 | fix |
Toglie Vecchia Fiera dalle fermate | Aggiunto cose varie. |
Verbo alla terza persona, maiuscola, niente punto, una cosa sola.
git log: le foto scattate
git log --oneline00d5f85 Aggiunge la corsa delle 6:36
b12df3f Aggiunge gli orari del mattino
1ece7ce Aggiunge le fermate della Linea Menta
5c2c617 Primo commit: il README del tabelloneUna riga per foto, la più recente in alto: il codice corto e il messaggio. Con --graph Git disegna anche le frecce, in verticale. Finché la storia è dritta è una colonna di asterischi:
* 00d5f85 Aggiunge la corsa delle 6:36
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabelloneCon i branch diventa un disegno vero: lo vedi nel capitolo 3. Il git log senza opzioni mostra anche autore e data, e se è lungo apre una schermata che si chiude con q.
git diff: cosa è cambiato, riga per riga
git status dice quali file. git diff dice quali righe. Ci sono due versioni, una per posto:
| Comando | Confronta | Risponde a |
|---|---|---|
git diff | scrivania con set | «Cosa ho cambiato e non ho ancora messo sul set?» |
git diff --staged | set con album | «Cosa c'è sul set, cioè cosa entrerà nella foto?» |
diff --git a/orari.txt b/orari.txt
index c172a6e..e514476 100644
--- a/orari.txt
+++ b/orari.txt
@@ -1,3 +1,4 @@
06:00 M12 per Piazza Query
06:12 M14 per Piazza Query
06:24 M16 per Piazza Query
+06:36 M18 per Piazza QueryCome si legge: le righe con il + sono aggiunte, quelle con il - sono tolte, quelle senza segno sono solo il contesto, per farti capire dove siamo. La riga con @@ dice a che altezza del file.
git restore: tornare indietro di un passo
Due comandi, per due errori diversi. Non confonderli.
| Hai fatto | Comando | Cosa succede |
|---|---|---|
| Un file è finito sul set per sbaglio | git restore --staged fermate.txt | Torna sulla scrivania. Le tue modifiche restano nel file |
| Una modifica sulla scrivania è sbagliata | git restore fermate.txt | Il file torna com'era nell'ultima foto. Le modifiche si perdono |
Il giro, in una tabella
| Voglio… | Comando |
|---|---|
| Sapere dove sta ogni file | git status |
| Vedere le righe cambiate sulla scrivania | git diff |
| Vedere le righe che sono sul set | git diff --staged |
| Mettere un file sul set | git add file |
| Mettere sul set un pezzo alla volta | git add -p file |
| Scattare la foto | git commit -m "Messaggio" |
| Vedere le foto scattate | git log --oneline --graph |
| Togliere un file dal set | git restore --staged file |
| Buttare le modifiche di un file | git restore file |
Ricorda
- Quattro posti: scrivania, set, album, album online. Il commit fotografa il set.
git statusprima e dopo ogni comando: è la bussola.git addsceglie;git add .non sceglie, mette tutto.- Un messaggio dice cosa fa il commit: «Aggiunge…», «Corregge…», mai «modifiche».
git diffguarda la scrivania,git diff --stagedguarda il set.restore --stagedtoglie dal set e non perde niente;restoresenza--stagedbutta le modifiche.