Come Annullare in Sicurezza gli Errori di Git: Spiegazione di Revert, Reset e Checkout

Gli errori di Git di solito sembrano peggiori di quanto siano. Potresti aver committato il file sbagliato, aver messo in stage troppo, o aver spinto una modifica errata su un branch condiviso. La soluzione sicura dipende da una domanda: la modifica è già stata condivisa?

Questa guida spiega quando usare git revert, git reset e git checkout, con esempi che puoi copiare con attenzione. La versione breve è semplice: usa git revert per i commit condivisi, git reset per la pulizia locale, e git checkout solo quando intendi cambiare branch o ripristinare stati precedenti di file.

Prima, Controlla Cosa Stai per Annullare

Prima di eseguire qualsiasi comando di annullamento, guarda lo stato attuale:

git status
git log --oneline --decorate -5

git status ti dice se hai lavoro non in stage, in stage o non tracciato. git log mostra i commit recenti e dove punta il tuo branch.

Se hai lavoro locale che non vuoi perdere, crea prima un branch di sicurezza veloce:

git branch backup-prima-di-annullare

Quel branch ti dà una via di ritorno facile se scegli il comando sbagliato.

Usa git revert per i Commit Già Spinti

git revert crea un nuovo commit che applica l'opposto di un commit precedente. Non cancella la cronologia, quindi è la scelta più sicura per branch condivisi come main, develop o qualsiasi branch che altre persone potrebbero aver scaricato.

Supponiamo che la tua cronologia sia così:

A -- B -- C -- D  main

Il commit C ha introdotto un bug, ma D è buono e deve rimanere. Trova l'hash del commit:

git log --oneline

Poi annulla solo quel commit:

git revert abcdef1

Git apre il tuo editor per il messaggio del commit di revert. Dopo averlo salvato, la cronologia appare così:

A -- B -- C -- D -- E  main

Il commit E annulla le modifiche di C. Tutti possono fare pull di quel nuovo commit normalmente.

Annullare un Commit di Merge

I commit di merge necessitano di un flag extra perché Git deve sapere quale genitore è la linea principale:

git revert -m 1 <hash-commit-merge>

Per un merge normale in main, -m 1 di solito significa "mantieni il primo genitore", cioè il branch in cui hai fatto il merge. Non indovinare qui. Esegui prima questo e ispeziona i genitori:

git show --summary <hash-commit-merge>

Se non sei sicuro di quale genitore mantenere, chiedi a un compagno di squadra o testa il revert su un branch temporaneo.

Usa git reset per i Commit Locali

git reset sposta il puntatore del tuo branch corrente. A seconda della modalità, può anche cambiare l'area di stage e i tuoi file di lavoro. Usalo principalmente per commit che non hai spinto.

Rimuovere un File dallo Stage

Se hai messo in stage il file sbagliato, rimuovilo dallo stage senza cambiare il contenuto del file:

git restore --staged file_indesiderato.txt

Esempi più vecchi di Git usano spesso questo comando equivalente:

git reset HEAD file_indesiderato.txt

Entrambi rimuovono il file dall'area di stage. Le tue modifiche rimangono nella directory di lavoro.

Annullare l'Ultimo Commit ma Mantenere le Modifiche in Stage

Usa --soft quando il messaggio del commit era sbagliato o vuoi aggiungere un altro file prima di ricommittare:

git reset --soft HEAD~1

Il tuo branch torna indietro di un commit, ma le modifiche di quel commit rimangono in stage.

Annullare l'Ultimo Commit e Mantenere le Modifiche Non in Stage

Usa il reset misto predefinito quando vuoi rielaborare i file prima di committare di nuovo:

git reset HEAD~1

Questo sposta il branch indietro di un commit e lascia le modifiche nella tua directory di lavoro.

Buttare Via Commit Locali e Modifiche ai File

--hard resetta il branch, l'area di stage e i file tracciati nella tua directory di lavoro:

git reset --hard HEAD~1

Usalo solo quando sei certo di non aver bisogno delle modifiche scartate. Non rimuove i file non tracciati, ma scarterà le modifiche ai file tracciati senza chiedere di nuovo.

Usa git checkout con Attenzione

git checkout ha due compiti comuni nei flussi di lavoro Git più vecchi: cambiare branch e ripristinare file. Le versioni più recenti di Git dividono questi compiti in comandi più chiari: git switch per i branch e git restore per i file.

Per cambiare branch:

git switch main

Equivalente più vecchio:

git checkout main

Per scartare modifiche non committate in un file tracciato:

git restore mio_file.txt

Equivalente più vecchio:

git checkout -- mio_file.txt

Quel ripristino di file è distruttivo per le modifiche non committate nel file selezionato. Se potresti aver bisogno delle modifiche in seguito, mettile prima in stash:

git stash push -m "salva lavoro prima del ripristino"

Usa git reflog Se Sei Andato Troppo Oltre

Se hai eseguito git reset --hard o hai spostato un branch per errore, git reflog potrebbe ancora mostrare dove puntava HEAD:

git reflog

Potresti vedere una voce precedente come HEAD@{2} o un hash di commit prima del reset. Puoi creare un branch di recupero da essa:

git branch recupero <hash-commit>

Reflog è locale al tuo clone e non è un sistema di backup, ma spesso ti salva da errori recenti.

Quale Comando Dovresti Scegliere?

Usa git revert quando il commit errato è già stato spinto o altre persone potrebbero aver basato il loro lavoro su di esso.

Usa git reset --soft quando il tuo ultimo commit locale deve essere rifatto ma le modifiche sono ancora corrette.

Usa git reset quando vuoi che l'ultimo commit locale torni come modifiche ai file non in stage.

Usa git reset --hard solo quando le modifiche locali tracciate possono essere cancellate.

Usa git restore o git checkout -- <file> quando vuoi scartare modifiche non committate in file specifici.

L'abitudine più sicura è controllare git status, creare un branch di backup temporaneo quando la posta in gioco è alta, ed evitare di riscrivere la cronologia condivisa. Se un commit ha raggiunto un remoto condiviso, git revert è di solito la soluzione più pulita.