Pleume — Manuale completo di Python 3 • 02 Installazione e ambiente

Obiettivo del capitolo

Preparare un ambiente di lavoro semplice, ripetibile e pulito su Windows, macOS e Linux. Vedremo come installare Python 3, verificare la versione, usare il Terminal (terminale), creare Virtual Environments (ambienti virtuali) con venv, gestire pacchetti con pip e organizzare cartelle di progetto senza confusione.

Verificare se Python è già installato

Apri il Terminal (Prompt dei comandi su Windows, Terminale su macOS/Linux) e prova:

python --version
python3 --version

Se vedi una versione del tipo Python 3.x.y sei a posto. Su Windows potresti avere il Python Launcher (lanciatore) e allora funziona anche:

py --version

Installazione su Windows

1. Scarica l'installer ufficiale di Python 3 per Windows dal sito Python.
2. Avvia l'installer e spunta “Add Python to PATH” (aggiungi Python al percorso).
3. Completa l'installazione con le impostazioni raccomandate.

Verifica dal Prompt dei comandi:

python --version
py --version

Avviare il terminale

Premi Win e cerca “Prompt dei comandi” oppure “PowerShell”.

Installazione su macOS

Opzione 1 (consigliata): usa Homebrew (gestore pacchetti).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install python

Opzione 2: scarica l'installer dal sito Python e segui la procedura grafica. Verifica poi nel Terminale:

python3 --version

Su macOS il comando può essere python3. In questo manuale, quando diciamo python, se necessario leggi python3.

Installazione su Linux

sudo apt update
sudo apt install -y python3 python3-pip python3-venv

sudo dnf install -y python3 python3-pip python3-venv

sudo pacman -Syu python python-pip

Verifica:

python3 --version

Uso essenziale del Terminal

• Current Directory (cartella corrente): dove il terminale “si trova”.
• cd (change directory): cambia cartella. Esempio: cd Documenti.
• ls/dir (elenca contenuti): ls su macOS/Linux, dir su Windows.
• python/python3: esegue file .py o apre il REPL.

cd Documenti
mkdir progetti-python
cd progetti-python

Struttura minima di un progetto

progetti-python/
└─ primo-progetto/
   ├─ README.md
   ├─ requirements.txt
   ├─ .venv/              # ambiente virtuale
   └─ src/
      └─ main.py

Creeremo la cartella src/ per il codice, un README.md con le istruzioni e requirements.txt per i pacchetti. L'ambiente virtuale risiede in .venv/.

Creare e attivare un Virtual Environment (venv)

Gli ambienti virtuali isolano i pacchetti di un progetto dagli altri. Così eviti conflitti di versioni.

Creazione

# Windows
python -m venv .venv

# macOS/Linux
python3 -m venv .venv

Attivazione

# Windows (cmd)
.venv\Scripts\activate

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

# macOS/Linux (bash/zsh)
source .venv/bin/activate

Se l’attivazione è riuscita, vedrai (.venv) all’inizio della riga del terminale. Per disattivare:

deactivate

Gestire pacchetti con pip

Assicurati di avere pip aggiornato:

python -m pip install --upgrade pip
# oppure
python3 -m pip install --upgrade pip

Installare, elencare, salvare i pacchetti

pip install requests
pip list
pip freeze > requirements.txt
pip install -r requirements.txt

Esegui questi comandi con l’ambiente .venv attivo per installare i pacchetti solo nel progetto.

Scegliere un editor

Qualsiasi editor di testo moderno va bene. Cerca funzionalità come syntax highlighting (evidenziazione), linting (analisi del codice) e integrazione del terminale. Mantieni la configurazione minimale: poche estensioni, tema leggibile, monospace font (font a larghezza fissa).

Risoluzione problemi comuni

Il comando python non è riconosciuto

Su Windows reinstalla selezionando “Add Python to PATH”. Su macOS/Linux prova python3. In alternativa specifica il percorso completo dell'eseguibile.

Permessi su macOS/Linux all’attivazione di .venv

Se vedi un messaggio su permessi o Execution Policy (Windows/PowerShell), abilita temporaneamente gli script per la sessione corrente:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

pip install fallisce

Verifica la connessione e riprova. Se necessario aggiorna gli strumenti di compilazione (soprattutto su Windows) oppure usa ruote precompilate quando disponibili.