Il terminale, le cartelle e il tuo primo progetto

Il problema che stiamo risolvendo

Nel capitolo precedente hai installato Python ed eseguito un file. Ma qualcosa è accaduto in silenzio nel frattempo: quando hai eseguito il file, il terminale era già aperto proprio in quella cartella. È stato VS Code a farlo per te.

Non sarà sempre così. Quando il terminale si trova in una cartella diversa, devi andare tu stesso nella cartella del file. È proprio questo "andare" che intrappola i principianti più di qualsiasi altra cosa. Il codice va bene, Python va bene, ma il terminale si trova in una cartella diversa — e Python segnala che il file non esiste.

Al lavoro lo farai qualche centinaio di volte al giorno. Oggi trasformeremo il terminale da uno schermo nero sconosciuto in uno strumento che conosci.

Alla fine di questo capitolo sarai in grado di

• Capire in quale cartella si trova attualmente il terminale
• Spostarti da una cartella all'altra e tornare indietro di un livello
• Creare una cartella di progetto ed eseguirvi un file
• Aprire e chiudere la shell interattiva di Python (il REPL)
• Spiegare la differenza tra il REPL e un file .py — questa confusione fa perdere un sacco di tempo

Prerequisiti: Installare Python ed eseguire il tuo primo programma.

Che cos'è realmente il terminale

Il terminale è un luogo in cui dai comandi al computer digitandoli invece di cliccare. E ogni finestra del terminale si trova sempre "in piedi" dentro qualche cartella. Quella cartella si chiama directory corrente.

È proprio questo il concetto fondamentale. Quando digiti python hello.py, stai in realtà dicendo: "Esegui il file `hello.py` nella cartella in cui mi trovo adesso." Se il file si trova in un'altra cartella, Python non lo troverà — perché non cerca altrove.

I comandi di questo capitolo sono quasi gli stessi su Windows PowerShell, Terminal di macOS e Terminal di Linux. Dove differiscono, vengono mostrate entrambe le versioni.

Apri PowerShell su Windows e vedrai di solito qualcosa del genere:

PS C:\Users\Rafi>

Su macOS, qualcosa del genere:

rafi@MacBook ~ %

Su Linux, qualcosa del genere:

rafi@laptop:~$

Questa riga si chiama prompt — il terminale è in attesa del tuo comando. Su Windows la parte C:\Users\Rafi ti dice dove ti trovi. Su macOS e Linux il simbolo ~ indica la tua cartella home.

Quattro comandi che bastano

pwd — dove mi trovo?

pwd

Su Windows PowerShell la risposta sarà così:

Path
----
C:\Users\Rafi

Su macOS o Linux otterrai direttamente il percorso:

/home/rafi

(Su macOS il percorso è /Users/rafi.)

ls — cosa c'è qui dentro?

ls

Elenca cartelle e file. ls funziona su tutti e tre i sistemi; su Windows c'è anche un comando più vecchio per lo stesso scopo, dir. Eseguire ls prima di lanciare un file è una buona abitudine — ti permette di verificare che il file che stai per eseguire sia davvero lì.

cd — spostarsi in un'altra cartella

cd python-lab

Due punti servono per salire di un livello:

cd ..

E per tornare direttamente alla tua cartella home da qualsiasi posizione:

cd ~

Questi tre comandi funzionano allo stesso modo su Windows, macOS e Linux.

Digita meno. Scrivi le prime due o tre lettere di una cartella o di un file e premi Tab — il terminale completerà il resto. Digitare a mano i nomi è la principale fonte di errori di battitura, e il tasto Tab li elimina.

mkdir — creare una nuova cartella

mkdir lesson-02

Preparare una cartella di progetto

Se spargi i tuoi file sul Desktop mentre impari, tra una settimana non troverai più nulla. Scegli quindi un posto unico e dai a ogni capitolo la sua cartella. Nel capitolo precedente hai creato python-lab nella tua cartella home; ora crea la cartella di questo capitolo al suo interno:

cd ~
cd python-lab
mkdir lesson-02
cd lesson-02
pwd

Se python-lab non esiste ancora, esegui mkdir python-lab dopo cd ~. Questi comandi sono identici su tutti e tre i sistemi.

Su Windows, l'ultimo comando dovrebbe restituire:

Path
----
C:\Users\Rafi\python-lab\lesson-02

Su Linux:

/home/rafi/python-lab/lesson-02

Su macOS il percorso inizia con /Users/rafi. Al posto di Rafi o rafi comparirà il tuo nome utente.

Ora crea un file chiamato notes.py in questa cartella con questo contenuto:

print("Folder:", "lesson-02")
print("Squares:", 2 * 2, 3 * 3, 4 * 4)

Ed eseguilo — su Windows:

python notes.py

Su macOS o Linux:

python3 notes.py

Folder: lesson-02
Squares: 4 9 16

La shell interattiva di Python

Digita solo python nel terminale (python3 su macOS e Linux) e premi Invio: si aprirà Python stesso:

python3

Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

La prima riga sarà diversa sul tuo computer — mostra la versione di Python, una data e il nome del tuo sistema operativo (su Windows finisce con on win32, su macOS con on darwin). Il simbolo >>> è lo stesso ovunque e significa che Python è in attesa di un tuo comando. Qualsiasi cosa digiti qui viene risposta immediatamente:

>>> 2 + 3
5
>>> "Python"
'Python'
>>> len("terminal")
8

Si chiama REPL — Read, Eval, Print, Loop (Leggi, Valuta, Stampa, Ripeti). È molto utile per verificare qualcosa di piccolo: se un calcolo è corretto o cosa restituisce una funzione.

Per uscire:

>>> exit()

La differenza che costa ore: nel REPL, digitando 2 + 3 viene mostrato 5 direttamente. Ma se metti solo 2 + 3 in un file .py ed eseguilo, non appare nulla — Python esegue l'operazione aritmetica, getta via il risultato e resta in silenzio. In un file devi usare print per vedere qualcosa. Questa è la vera differenza tra il REPL e uno script.

Quando qualcosa va storto

python : The term 'python' is not recognized... (Windows) o command not found: python (macOS, Linux) Su Windows, Python non è su PATH — guarda la sezione "Quando qualcosa va storto" del capitolo precedente: riesegui l'installer e spunta la casella sotto Modify. Su macOS e Linux il comando si chiama python3.

can't open file '...notes.py': [Errno 2] No such file or directory Il terminale si trova nella cartella sbagliata o c'è un errore di battitura nel nome del file. Esegui pwd per vedere dove ti trovi, poi ls per verificare che il file sia presente.

cd : Cannot find path ... because it does not exist (Windows) o cd: no such file or directory (macOS, Linux) La cartella non è ancora stata creata o il nome è sbagliato. Creala con mkdir e, la prossima volta, usa il tasto Tab per digitare il nome.

Il terminale sembra bloccato e mostra solo >>> Ti trovi dentro il REPL, non fuori. ls e python notes.py non funzioneranno qui — sono comandi del terminale, non di Python. Digita exit() per uscire.

Il nome della cartella contiene spazi Metti tutto il nome tra virgolette: cd "my python lab". Questo funziona su tutti e tre i sistemi. Dare nomi senza spazi alle cartelle evita del tutto il problema, ed è per questo che python-lab e my_notes sono abitudini migliori.

Tocca a te

Dal terminale, usando solo i comandi:

1. Crea una cartella chiamata practice dentro python-lab
2. Spostati al suo interno e verifica con pwd
3. Crea lì un file chiamato about.py che stampi il tuo nome e la data odierna
4. Eseguilo con python about.py (python3 about.py su macOS o Linux)
5. Ora fai cd .. per tornare indietro di un livello ed esegui di nuovo lo stesso comando — cosa succede?

Questo ultimo passaggio è la lezione vera. Una volta visto l'errore di proposito, lo riconoscerai subito quando si presenterà nel mondo reale.