Rimettere a posto, se qualcosa va storto
I messaggi che vedrai, e le cose che non danno messaggi
I messaggi che vedrai di più quando cambi branch con il lavoro a metà, ti perdi nella HEAD staccata, ricopi dei commit o fai pulizia nei file. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Ricorda come si leggono: Git scrive la cosa importante in cima (error, fatal, CONFLICT) e poi, in fondo o dopo hint:, ti dice cosa fare. Leggi anche quelle righe: spesso contengono già il comando.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
error: Your local changes to the following files would be overwritten by checkout: e Please commit your changes or stash them before you switch branches. | Il file è diverso tra i due branch, e tu l'hai modificato: cambiando branch perderesti le tue righe. Git non ha toccato niente | Se il lavoro è pronto: git add e git commit. Se è a metà: git stash, cambi branch, e quando torni git stash pop |
You are in 'detached HEAD' state. (o HEAD detached at 1ece7ce in git status) | HEAD punta a un commit, non a un branch: hai guardato una vecchia foto | Hai solo guardato: git switch main. Se vuoi tenere i commit che farai: git switch -c nome |
Warning: you are leaving 1 commit behind, not connected to any of your branches: | Stai lasciando la HEAD staccata, e quel commit non ha nessuna etichetta. Il codice è nell'avviso | Subito: git branch nome codice, con il codice scritto nell'avviso. Poi git switch nome |
error: The following untracked working tree files would be overwritten by merge: e .vscode/settings.json | Un commit in arrivo con git pull ha un file che hai già sul disco, ma non seguito: Git non lo sovrascrive | Sposta o rinomina il tuo file, git pull, poi rimettilo (se serve, scrivilo nel .gitignore) |
CONFLICT (content): Merge conflict in orari.txt dopo git stash pop, e The stash entry is kept in case you need it again. | Le righe nel cassetto toccano la stessa riga che nel frattempo è cambiata: conflitto, come in un merge. Il cassetto non si svuota da solo | Risolvi come nel capitolo I conflitti (nel file i segni dicono Updated upstream e Stashed changes), poi git add orari.txt, git restore --staged orari.txt (la modifica resta sulla scrivania) e git stash drop per svuotare il cassetto |
! [rejected] turni -> turni (non-fast-forward) dopo un git rebase | Hai ricopiato commit che erano già sul GitHub: i codici nuovi non combaciano con quelli vecchi | Non forzare il push: --force sovrascrive il lavoro degli altri. Scrivi git pull: unisce le due storie con un merge, e poi git push riesce. La prossima volta, niente rebase su commit già mandati |
fatal: no rebase in progress | Hai scritto git rebase --abort (o --continue), ma non c'è un rebase a metà | git status: ti dice se sei a metà di qualcosa. Se il rebase è finito e non lo vuoi, non è più una questione di --abort |
git stash list non risponde niente, ma credevi di avere del lavoro da parte | Il cassetto è vuoto: il pop l'hai già fatto, o lo stash non è mai partito | git status e git log --oneline per capire dove sei. Se il lavoro non c'è più, non è in nessun album |
Cose che non danno messaggi
I guai più difficili sono quelli senza errore: Git ha fatto quello che hai chiesto, ma non era quello che volevi.
Il lavoro dimenticato nel cassetto. Hai fatto git stash, sei andato su main, e il git stash pop non è mai arrivato. Niente avvisa. Prima di chiudere, un git stash list: deve essere vuoto.
Il commit orfano. Un commit nella HEAD staccata, poi git switch main: niente di rotto, solo un commit senza etichetta. Se ti accorgi del problema, cerca il codice nell'avviso e usa git branch.
Il .gitignore che «non funziona». Hai scritto .venv/ e git status continua a mostrare modified: .venv/…: vuol dire che il file era già nell'album. Il .gitignore guarda solo i file non seguiti. La cura è nel capitolo: git rm -r --cached, il .gitignore, un commit.
git rm senza --cached. Cancella anche dal disco. Se l'hai fatto per sbaglio e non hai ancora committato, git restore --staged cartella e git restore cartella rimettono tutto a posto.
Il git restore troppo largo. Con il punto butta tutte le modifiche, non solo quelle che pensavi. Meglio sempre il nome del file.
Il rebase su commit condivisi. Il rebase riesce, tutto sembra a posto, e il guaio arriva al git push. Ricordalo prima: rebase solo su commit che hai solo tu.
Per i guai di Git che non sono di questo capitolo c'è il Pronto soccorso.