Imparare Git: il tutorial completo per principianti

Git è un sistema di controllo di versione distribuito. Registra lo stato dei tuoi file a ogni tappa del lavoro, ti permette di tornare indietro e rende possibile lavorare in più persone sullo stesso progetto senza sovrascriversi a vicenda. È lo strumento di base del mestiere di sviluppatore: si usa tanto per uno script di cento righe quanto per il kernel Linux.

Git non è GitHub

È la confusione più frequente quando si comincia. Git è un programma che gira sulla tua macchina e che gestisce la cronologia del progetto in una cartella nascosta, .git. Funziona senza connessione a internet e senza un account da nessuna parte.

GitHub, GitLab o Bitbucket ospitano repository Git. Conservano una copia del tuo progetto sui loro server, fanno da punto di ritrovo per un team e aggiungono i propri strumenti attorno a Git: gestione dei ticket, revisione del codice, integrazione continua. Puoi usare Git per tutta la vita senza aprire un account GitHub. Il contrario non ha senso.

In questo tutorial Git è lo strumento che impari, GitHub e GitLab sono i servizi che usi per condividere il tuo lavoro.

Che cosa saprai fare alla fine

• Installare Git e configurarlo bene al primo colpo, autenticazione con chiave SSH compresa.
• Creare un repository su GitHub o GitLab e collegarlo a una cartella della tua macchina, nei due sensi.
• Registrare il tuo lavoro in tappe leggibili, consultare la cronologia e annullare un errore senza perdere tutto.
• Lavorare su un branch, farne il merge e risolvere un conflitto a mano.
• Scegliere il modello di branch adatto al tuo team, fra Gitflow e trunk-based development.

Che cosa ti serve

Un terminale e nient’altro. Questo tutorial non usa nessuna interfaccia grafica: né GitHub Desktop, né la scheda Git del tuo editor. Sono strumenti comodi una volta che hai capito che cosa fanno al posto tuo, e ingannevoli prima. Tutti i comandi funzionano allo stesso modo su Windows (dentro Git Bash), macOS e Linux.

Non serve nessuna conoscenza preliminare, ma sapersi muovere in un terminale con cd e ls aiuta parecchio.

Due parole sulle versioni

Git è un software stabile e lento a cambiare: i comandi di questo tutorial funzionano da anni e continueranno a funzionare. Due punti si muovono comunque, e sono trattati in modo esplicito nei capitoli interessati.

Prima di tutto i comandi git switch e git restore, comparsi con Git 2.23 nel 2019, che sostituiscono con vantaggio git checkout per cambiare branch e annullare le modifiche. Nella documentazione ufficiale non sono più marcati come sperimentali. Questo tutorial insegna prima loro, e dà l’equivalente con git checkout perché tu riesca a leggere il codice degli altri.

Poi il nome del branch predefinito. Contrariamente a un’idea diffusa, in Git 2.55 git init crea ancora un branch master, non main. Il cambiamento è annunciato per Git 3.0. Il primo capitolo ti mostra come sistemare la cosa una volta per tutte.

Il percorso

1. Installare e configurare Git, installazione per sistema, identità, branch predefinito e autenticazione con chiave SSH o token.
2. Creare un repository e recuperarlo in locale, le due strade possibili: clonare un repository esistente, oppure pubblicare una cartella che hai già.
3. I comandi di base — status, add, commit, push, pull, il file .gitignore e soprattutto come annullare una sciocchezza.
4. Lavorare in team con i branch, creare un branch, farne il merge, risolvere un conflitto e scegliere fra merge e rebase.
5. Gitflow o trunk-based, i due modelli di branch, i loro comandi e in quale contesto ciascuno si giustifica.

I capitoli si seguono: ognuno riprende il progetto dove l’ha lasciato il precedente. Puoi comunque entrare direttamente in quello che ti interessa, i comandi necessari sono richiamati sul posto.

Questo tutorial fa parte del percorso Sviluppo web di Gekkode.