Il giro di ogni giorno, se qualcosa va storto
Dieci messaggi, dieci uscite
I messaggi che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Un consiglio che vale per tutti: leggi git status fino in fondo. Quasi sempre contiene già il comando giusto, scritto tra parentesi.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
fatal: not a git repository (or any of the parent directories): .git | La cartella dove sei non è un repository: non c'è nessun album | Sei nella cartella giusta? Controlla con pwd e ls. Se è la cartella giusta e Git non la segue ancora: git init -b main |
Author identity unknown e *** Please tell me who you are. | Git non sa chi sei, quindi non sa chi firma il commit | git config --global user.name "Nome Cognome" e git config --global user.email "la-tua@email", poi riprova il commit. Si fa una volta sola per computer |
nothing added to commit but untracked files present | Hai fatto git commit, ma sul set non c'è niente: ci sono solo file nuovi | Metti il file sul set: git add nome-del-file, poi di nuovo il commit |
no changes added to commit (use "git add" and/or "git commit -a") | Ci sono file modificati, ma nessuno è sul set | git add nome-del-file, poi il commit. Se non vuoi scegliere, git add . (ma guarda prima git status) |
nothing to commit, working tree clean | Non c'è niente da fotografare: tutto è già nell'album | Hai salvato il file in VS Code? Se la scheda ha un pallino accanto al nome, non è salvato: Ctrl+S (Mac: Cmd+S) |
fatal: pathspec 'oggetti.text' did not match any files (con restore: error: pathspec … did not match any file(s) known to git) | Il nome del file non esiste | Controlla il nome con ls o con git status: tra .txt e .text basta una lettera. Con Tab il terminale lo completa per te |
Il terminale mostra (END) e non torna al prompt | git log (o git diff) è lungo e Git lo mostra in una schermata a parte | Premi q. Con le frecce o la barra spaziatrice scorri |
| Si apre un editor con delle righe grigie, e non sai uscire | Hai scritto git commit senza -m: Git ti chiede il messaggio | nano (Ubuntu): scrivi il messaggio, poi Ctrl+O, Invio, Ctrl+X. vim (Mac): premi i, scrivi, poi Esc, :wq e Invio. Se esci senza messaggio, il commit viene annullato: niente di grave |
git diff non scrive niente, ma sei sicuro di aver cambiato un file | La modifica è già sul set (hai fatto git add), oppure il file non è salvato, oppure è nuovo | Prova git diff --staged. Poi git status: è Untracked? Allora git diff non lo mostra mai |
On branch master invece di On branch main | Hai fatto git init senza -b main su un computer che parte da master | Se non hai ancora fatto commit importanti: git branch -M main rinomina il branch |
Gli errori che non danno errori
I più difficili sono quelli senza messaggio: Git fa quello che hai chiesto, ma non era quello che volevi. In questo capitolo sono quasi sempre questi.
Il commit con dentro troppo. git add . o git commit -a hanno messo nella foto un file che non doveva esserci. Prima di scattare, git status e git diff --staged: dicono cosa c'è sul set. Se il commit è già fatto, non si cancella (è la regola 1 del grafo): si rimedia nel capitolo 6.
Le modifiche buttate. git restore file ha riportato il file com'era nell'ultima foto, e quello che avevi scritto non c'è più. Non si recupera. Prima di buttare: git diff file.
Il messaggio che non dice niente. modifiche, fix, aggiornamento: Git li accetta, ma tra un mese non sapresti cosa c'è in quella foto. Prova a completare «questo commit…»: aggiunge la corsa delle 6:36, corregge l'orario del M14.
Il commit che non c'è. Hai fatto git add ma non il commit: git log --oneline non ha la riga nuova. Dopo ogni commit, git status: se dice nothing to commit, working tree clean, la foto è stata scattata.
Se il problema non è Git
Il test non parte, pytest: command not found, il pannello Testing vuoto: non è il tuo repository, è l'ambiente. È la pagina pytest non parte, o non trova niente. Per i guai di Git che non sono in questa tabella: Il Pronto soccorso di Git.