Il venv e pip, esercizi spiegati
Cinque esempi, un comando alla volta
- 20 minuti di lettura
Cinque esempi, uno per ogni pezzo del capitolo. Ognuno ha lo stesso ritmo:
- Prevedi: leggi i comandi e scrivi su un foglio cosa risponde il terminale. Prima di aprire la risposta.
- In italiano: cosa succede, a parole.
- Passo per passo: cosa cambia a ogni comando.
- Cosa portiamo a casa: la cosa da ricordare.
Puoi rifarli sul tuo computer in una cartella di prova: crea una cartella con mkdir -p ~/corso/prova-venv, entraci con cd, e lancia i comandi uno alla volta. Ricorda che il venv, qui, lo cancelli quando vuoi.
Negli esempi il prompt non c'è (così copi solo i comandi). Quando il venv è acceso, il tuo comincia con (.venv).
A · Quale Python ha fatto quel venv?
Nella cartella del tabellone facciamo due venv, con due Python diversi: quello che Apple mette sul Mac (/usr/bin/python3) e il 3.12 del corso. Poi ci chiediamo con quale è nato ciascuno.
/usr/bin/python3 -m venv .venv-vecchio
python3.12 -m venv .venv-nuovo
grep version .venv-vecchio/pyvenv.cfg .venv-nuovo/pyvenv.cfgPrevedi Scrivi su un foglio cosa ti aspetti, poi apri.
.venv-vecchio/pyvenv.cfg:version = 3.9.6
.venv-nuovo/pyvenv.cfg:version = 3.12.13- I primi due comandi non stampano niente: se va tutto bene, i venv si creano in silenzio.
grepcerca la parolaversiondentro i due filepyvenv.cfge stampa le righe che la contengono, ognuna con il nome del suo file.- Il venv vecchio ha il 3.9.6: l'ha fatto il Python di Apple. Il nuovo il 3.12.13.
In italiano. Il file pyvenv.cfg, dentro ogni venv, è la carta d'identità: dice con quale Python è nato. Quel Python se lo porta dietro: cambiare Python sul computer non cambia i venv già fatti.
Passo per passo.
| Comando | Cosa succede | Cosa c'è di nuovo |
|---|---|---|
/usr/bin/python3 -m venv .venv-vecchio | Il Python 3.9 crea una cartella | .venv-vecchio/, con Python 3.9 dentro |
python3.12 -m venv .venv-nuovo | Il Python 3.12 ne crea un'altra | .venv-nuovo/, con Python 3.12 dentro |
grep version … … | Cerca version in due file | Due righe, una per file |
Cosa portiamo a casa. Il venv è vecchio quanto il Python che lo ha creato. Un venv con Python troppo vecchio non si aggiorna: si butta e si rifà con python3.12 -m venv .venv.
B · Acceso, spento: chi risponde?
Su un Mac senza asdf, fuori dal venv il comando python non esiste. Lo scopriamo, accendiamo il venv, e lo ritroviamo. Il terminale è zsh.
which python
python --version
source .venv/bin/activate
which python
python --version
deactivate
which python
python --versionPrevedi Scrivi su un foglio cosa ti aspetti, poi apri.
python not found
zsh: command not found: python
/Users/marta/corso/tabellone/.venv/bin/python
Python 3.12.13
python not found
zsh: command not found: python- Venv spento:
which pythonnon trova niente, epython --versiondàcommand not found. sourceedeactivatenon stampano niente.- Venv acceso:
whichmostra il Python dentro.venv/bin, e la versione è quella del venv. - Dopo
deactivate: tutto com'era all'inizio.
Su bash (Ubuntu) i messaggi hanno altre parole (bash: python: command not found), ma il senso è uguale. Se hai asdf, python esiste anche a venv spento, e which python dice un percorso con .asdf/shims.
In italiano. Accendere il venv non cambia Python: cambia dove il terminale cerca i programmi. Mette .venv/bin in testa all'elenco, e python diventa quello del progetto. deactivate toglie la cartella dall'elenco.
Passo per passo.
| Comando | python esiste? | Dove? |
|---|---|---|
which python (spento) | No | Da nessuna parte |
source .venv/bin/activate | — | Il terminale ora cerca prima in .venv/bin |
which python (acceso) | Sì | …/tabellone/.venv/bin/python |
deactivate | — | Il terminale torna a cercare come prima |
which python (spento) | No | Da nessuna parte |
Cosa portiamo a casa. Quando un comando non si trova, o il Python non è quello che pensi, scrivi which python: la risposta dice chi sta rispondendo. Se non è un percorso con .venv, il venv è spento.
C · Una libreria, cinque righe
Nel venv acceso del tabellone installiamo requests, una libreria per parlare con i server. La scegliamo perché si porta dietro altre librerie: serve a vedere cosa scrive pip freeze.
pip install requests==2.32.3Collecting requests==2.32.3
Downloading requests-2.32.3-py3-none-any.whl.metadata (4.6 kB)
Collecting charset-normalizer<4,>=2 (from requests==2.32.3)
Downloading charset_normalizer-3.5.2-cp312-cp312-macosx_10_13_universal2.whl.metadata (46 kB)
Collecting idna<4,>=2.5 (from requests==2.32.3)
Downloading idna-3.20-py3-none-any.whl.metadata (7.2 kB)
Collecting urllib3<3,>=1.21.1 (from requests==2.32.3)
Downloading urllib3-2.8.0-py3-none-any.whl.metadata (7.4 kB)
Collecting certifi>=2017.4.17 (from requests==2.32.3)
Downloading certifi-2026.10.23-py3-none-any.whl.metadata (2.5 kB)
Downloading requests-2.32.3-py3-none-any.whl (64 kB)
Downloading certifi-2026.10.23-py3-none-any.whl (135 kB)
Downloading charset_normalizer-3.5.2-cp312-cp312-macosx_10_13_universal2.whl (367 kB)
Downloading idna-3.20-py3-none-any.whl (69 kB)
Downloading urllib3-2.8.0-py3-none-any.whl (135 kB)
Installing collected packages: urllib3, idna, charset-normalizer, certifi, requests
Successfully installed certifi-2026.10.23 charset-normalizer-3.5.2 idna-3.20 requests-2.32.3 urllib3-2.8.0
[notice] A new release of pip is available: 25.0.1 -> 26.3
[notice] To update, run: pip install --upgrade pipHai chiesto una libreria, ne sono arrivate cinque. Ora due comandi:
pip list
pip freeze > requirements.txt
cat requirements.txtQuante righe ha pip list? E quante requirements.txt? Quale riga c'è in una lista e non nell'altra?
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Package Version
------------------ ----------
certifi 2026.10.23
charset-normalizer 3.5.2
idna 3.20
pip 25.0.1
requests 2.32.3
urllib3 2.8.0
certifi==2026.10.23
charset-normalizer==3.5.2
idna==3.20
requests==2.32.3
urllib3==2.8.0pip listha due righe di intestazione e sei librerie: le cinque piùpip.requirements.txtha cinque righe:pipnon c'è, perchépip freezenon elenca pip stesso.- Le versioni sono scritte con
==: è il formato chepip install -rsa rileggere. - Le librerie sono in ordine alfabetico, non in ordine di installazione.
In italiano. requests ha bisogno di quattro librerie per funzionare, e pip le installa da solo. pip freeze le scrive tutte, con la versione precisa: così chi rifà il venv trova lo stesso ambiente, e non uno «più o meno».
Passo per passo.
| Comando | Cosa succede | Cosa c'è nel venv / nel file |
|---|---|---|
pip install requests==2.32.3 | pip scarica requests e le sue quattro compagne | Cinque librerie in più nel venv |
pip list | Stampa una tabella | Sei righe: le cinque più pip |
pip freeze > requirements.txt | Scrive l'elenco nel file, non sullo schermo | Il file requirements.txt, cinque righe |
cat requirements.txt | Legge il file | Le cinque righe |
Cosa portiamo a casa. Non scrivi requirements.txt a mano e non indovini le versioni: lo scrive pip freeze, a venv acceso e a venv riempito. Se lo lanci a venv spento, descrive un altro Python.
D · Buttalo e rifallo
Il venv del tabellone ha fatto il suo tempo. Lo buttiamo e lo rifacciamo uguale, con l'elenco che abbiamo scritto prima.
deactivate
rm -rf .venv
ls -a
python3 -m venv .venv
source .venv/bin/activate
pip list
pip install -r requirements.txt
pip listCosa mostra l'ultimo pip list? E quello prima, subito dopo aver rifatto il venv?
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Dopo rm -rf .venv e ls -a:
. .. requirements.txtDopo il venv nuovo, il primo pip list:
Package Version
------- -------
pip 25.0.1Dopo pip install -r requirements.txt, il secondo pip list:
Package Version
------------------ ----------
certifi 2026.10.23
charset-normalizer 3.5.2
idna 3.20
pip 25.0.1
requests 2.32.3
urllib3 2.8.0- Il venv è sparito, ma
requirements.txtè rimasto: non era dentro.venv. - Un venv appena fatto è vuoto: c'è solo
pip. pip install -rrimette le cinque librerie, alle stesse versioni di prima.
In italiano. Cancello la cartella del venv. Ne creo una nuova, la accendo, e le faccio leggere l'elenco. Il risultato è lo stesso di prima, ma partendo da zero: per questo un venv si può buttare senza paura.
Passo per passo.
| Comando | Cosa succede |
|---|---|
deactivate | Spegne il venv (da cancellare, meglio spento) |
rm -rf .venv | Cancella la cartella .venv e tutto quello che contiene |
ls -a | Mostra che .venv non c'è più, e che requirements.txt sì |
python3 -m venv .venv | Crea un venv nuovo e vuoto |
source .venv/bin/activate | Lo accende |
pip list | Solo pip |
pip install -r requirements.txt | Installa le cinque librerie dell'elenco |
pip list | Cinque librerie e pip: come prima |
Cosa portiamo a casa. Il venv è usa e getta, l'elenco requirements.txt no: quello è il tuo progetto. Per questo l'elenco va su GitHub e il venv no.
E · Il pip che non vuole
Tommaso ha aperto un terminale nuovo e scrive subito pip3 install tabulate, a venv spento, sul Python di Homebrew.
pip3 install tabulateCosa risponde? Quale riga del messaggio conta davvero?
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
La prima riga del messaggio:
error: externally-managed-environmentIl resto sono una trentina di righe di consigli: brew install, python3 -m venv, pipx, e in fondo --break-system-packages (da non usare). La risposta completa, per intero, è nella teoria.
- «Externally managed» vuol dire: questo Python lo gestisce Homebrew (o
apt), non tu. - pip si ferma prima di installare: non è stato installato niente, e non c'è niente da disinstallare.
- Il consiglio buono è nel mezzo:
python3 -m venv path/to/venvesource path/to/venv/bin/activate. È quello che facciamo da sempre.
In italiano. Il pip che ha risposto non è quello di un venv: è quello del Python del computer. I sistemi recenti non lasciano che ci installi le tue librerie, perché potresti rompere programmi che usa il sistema.
La cura è accendere il venv del progetto (ci sei nella cartella giusta?) e poi rifare il comando:
source .venv/bin/activate
pip install tabulateIl disegno.
Passo per passo.
| Cosa vedi | Cosa vuol dire | Cosa fai |
|---|---|---|
Il prompt non ha (.venv) | Il venv è spento | source .venv/bin/activate |
error: externally-managed-environment | pip è quello del sistema | Non insistere: accendi il venv |
Il prompt ha (.venv), pip install funziona | Ora scrive nel venv | Ricontrolla con pip list |
Cosa portiamo a casa. externally-managed-environment non è un errore del tuo progetto: è pip che ti dice «non sei nel venv». Il prompt e which pip ti avrebbero avvisato prima.