Il terminale, se qualcosa va storto
I messaggi che vedrai di più, e cosa farne
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
La prima mossa, sempre la stessa: pwd e ls. Dove sei? Cosa c'è qui? Nove volte su dieci il guaio è che non sei dove pensi.
I messaggi cambiano un po' tra Mac (zsh) e Ubuntu (bash): nella tabella ci sono le parole più comuni. Il senso è lo stesso.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
cd: no such file or directory: gallerie (zsh) · bash: cd: gallerie: No such file or directory | La cartella non c'è, da dove sei | pwd e ls: sei nel posto giusto? Se la cartella è altrove, cd con il percorso intero. Con Tab, se non completa, di solito è perché non c'è |
zsh: command not found: lss · bash: lss: command not found | Hai scritto male il comando, oppure quel programma non è installato | Rileggi: ls, non lss. Se è un programma installato da poco: chiudi e riapri il terminale |
ls: linea-menta/orari/M1: No such file or directory | Il percorso non porta a niente | Passo per passo: ls linea-menta, poi ls linea-menta/orari, finché non vedi dove si interrompe |
cat: orari.txt: No such file or directory | Il file non c'è, qui, con quel nome | ls: il nome è giusto? Su Ubuntu maiuscole e minuscole contano |
mkdir: archivio/2025: No such file or directory | Manca una cartella di mezzo | mkdir -p, che crea tutta la catena |
mkdir: linea-menta: File exists | Quella cartella c'è già | Nessun danno. Se volevi una cartella nuova, scegli un altro nome; se ti serve solo che esista, vai avanti |
cp: orari is a directory (not copied). | Stai copiando una cartella senza -r | cp -r orari copia |
rm: prova: is a directory | Stai cancellando una cartella senza -r | Guarda prima con ls prova cosa c'è dentro, poi rm -r prova |
mv: rename archivio/M16-nuovo.txt to nonesiste/M16.txt: No such file or directory | La cartella di destinazione non c'è | mkdir prima, poi mv |
zsh: no matches found: *.zip · rm: *.zip: No such file or directory | L'asterisco non ha trovato niente: non ci sono file così in questa cartella | ls: sei nella cartella giusta? C'è qualcosa che finisce in .zip? |
cd: string not in pwd: Verbali (zsh) · cd: Verbali: No such file or directory | Il nome ha uno spazio: il terminale lo legge come due nomi | Virgolette: cd "Verbali vecchi". Meglio ancora: niente spazi nei nomi, usa i trattini |
| Il prompt non torna, o il terminale sembra bloccato | Un comando sta ancora girando (o aspetta qualcosa) | Ctrl+C (anche su Mac: Ctrl, non Cmd). Poi il prompt torna |
| Scrivi un comando e non succede niente, o appaiono caratteri strani | Il terminale è ancora in attesa: una virgoletta non chiusa, o un comando a metà | Ctrl+C e riscrivi. La freccia in su richiama l'ultimo comando |
Permission denied | Non hai il permesso di toccare quel file o quella cartella | Quasi sempre sei nella cartella sbagliata (per esempio nei file di sistema). pwd, poi torna a casa con cd ~ |
Tutto è lentissimo, o Git e pytest fanno cose strane (WSL) | Stai lavorando in /mnt/c/..., i file di Windows | pwd. Se comincia con /mnt/, sposta lo zip in ~/corso e rifai lì |
bash: prepara.sh: No such file or directory | Non sei nella cartella della missione | pwd, poi cd nella cartella giusta. Si lancia con bash prepara.sh |
no tests ran | Hai lanciato pytest dentro campo/, dove non ci sono test | cd .., poi di nuovo pytest -v |
| Il test dice che manca qualcosa, ma tu l'hai fatto | Il comando è andato a finire in un posto diverso da come credevi | pwd per vedere dove eri, poi ls nel posto dove doveva finire. Aiuta riscrivere il percorso con Tab |
Gli errori che non danno errori
I più difficili sono quelli in cui il terminale non dice niente, e il risultato è sbagliato. In questo capitolo sono quasi sempre uno di questi:
mv che rinomina invece di spostare. mv file cartella-che-non-esiste non si lamenta: cambia il nome al file. Prima mkdir, poi mv. In dubbio, ls dopo.
Un percorso relativo dalla cartella sbagliata. mkdir -p progetti/tabellone crea quello che dici, ma da dove sei. Se non eri in campo/, le cartelle sono nate nel posto sbagliato, in silenzio. pwd prima, ls dopo.
cp -r dentro una cartella che esiste già. Se copia esiste, cp -r orari copia mette orari dentro copia. Sul Mac, con la barra finale (orari/), invece, mette dentro il contenuto: per questo la barra finale non si scrive mai.
L'asterisco che prende troppo. rm * non vuol dire «i file temporanei»: vuol dire tutto. Prima ls *.tmp, poi rm *.tmp.
I file nascosti che non ci sono. ls non mostra i file che cominciano per punto. Se una cartella sembra vuota e non lo è: ls -a.
Se il problema non è il terminale
pytest: command not found, No module named pytest: non è il terminale, è il venv spento. Il capitolo Il venv e pip lo spiega, e il Pronto soccorso ha la cura: pytest non parte, o non trova niente. Per i guai più comuni, in breve, anche la pagina Pronto soccorso: la ricerca trova i sintomi.