Installare Thonny e VS Code per imparare Python

Divento Programmatore — Appendice A: Setup Thonny e VS Code

Thonny — Per i Capitoli 1-6

Thonny è l'IDE perfetto per chi inizia: niente configurazioni, niente complicazioni.

Installazione di Thonny

1. Vai su thonny.org
2. Clicca "Download" per il tuo sistema (Windows / Mac / Linux)
3. Installa normalmente
4. Apri Thonny → sei pronto!

Prima configurazione consigliata

Vai in Tools → Options → Editor e assicurati che "Highlight matching names" sia attivo. Aiuta molto a leggere il codice evidenziando le variabili uguali.

Interfaccia di Thonny

Quando apri Thonny per la prima volta, vedrai due finestre principali:

| Finestra | Posizione | Funzione | | --- | --- | --- | | Editor | In alto | Qui scrivi il tuo programma (file .py) | | Shell | In basso | Qui il computer risponde ed esegue il codice interattivo |

Test rapido: Clicca nella Shell in basso, scrivi print("Ciao mondo!") e premi Invio. Se appare Ciao mondo! — funziona!

VS Code — Per i Capitoli 7+

VS Code è l'editor usato da milioni di sviluppatori professionisti in tutto il mondo. È gratuito, veloce e ha un ecosistema di estensioni enorme. Necessario per pygame (Capitoli 7 e 8) perché gestisce meglio le finestre grafiche in tempo reale.

Installazione di VS Code

1. Vai su code.visualstudio.com
2. Scarica e installa per il tuo sistema operativo
3. Apri VS Code
4. Vai nelle Estensioni (icona a quadretti sulla barra laterale sinistra, o Ctrl+Shift+X)
5. Cerca e installa: "Python" (di Microsoft) — indispensabile
6. Premi Ctrl+Shift+P (Windows/Linux) o Cmd+Shift+P (Mac) → digita "Python: Select Interpreter" → scegli la tua versione di Python

Estensioni consigliate

| Estensione | Descrizione | Perché serve | | ------------ | ------------- | -------------- | | Python (Microsoft) | Supporto completo Python: IntelliSense, debugging, testing | Indispensabile | | Pylance | Autocompletamento intelligente, type checking veloce | Migliora produttività | | Error Lens | Mostra gli errori direttamente a riga nel codice (inline) | Debug immediato | | Code Runner | Esegui snippet di codice con Ctrl+Alt+N | Test veloci |

Configurazione per pygame

Dopo aver installato l'estensione Python, installa pygame dal terminale integrato di VS Code (Ctrl+ù o Terminal → New Terminal):

pip install pygame

Verifica: Crea un file test_pygame.py con:

import pygame
print(pygame.ver)

Eseguilo (Ctrl+Alt+N con Code Runner o tasto destro → "Run Python File in Terminal"). Se vedi la versione stampata senza errori, sei pronto!

Cursor — Per il Volume 3 (Vibe Coding)

Cursor è un fork di VS Code con AI integrata nativamente. È il tool del Vibe Coding (Volume 3 della collana).

Installazione

1. Vai su cursor.sh
2. Scarica e installa
3. Al primo avvio ti chiede di accedere — crea un account gratuito
4. Importa le tue impostazioni di VS Code se le hai già

Superpoteri di Cursor

| Scorciatoia | Azione | | ------------- | -------- | | Ctrl+L | Seleziona codice e chiedi all'AI di spiegarlo | | Ctrl+K | Descrivi cosa vuoi e fallo generare | | Ctrl+Shift+L | Chiedi all'AI di correggere un bug selezionato | | Ctrl+I | Chat inline per modifiche mirate |

Troubleshooting Comune

Problema: "python non riconosciuto come comando interno" (Windows)

Causa: Python non è nel PATH di sistema.

Soluzione:

1. Reinstalla Python da python.org spuntando "Add Python to PATH"
2. Oppure: Cerca "Environment Variables" in Start → Modifica Path → Aggiungi la cartella Python (es: C:\Users\TuoNome\AppData\Local\Programs\Python\Python311\)

Problema: "Permission denied" su Mac/Linux

Causa: Permessi insufficienti per installare pacchetti.

Soluzione: Usa pip install --user pygame o configura un ambiente virtuale:

python -m venv venv
source venv/bin/activate  # Mac/Linux
# venv\Scripts\activate   # Windows
pip install pygame

Problema: Antivirus blocca l'esecuzione

Causa: Alcuni antivirus (es. Windows Defender, Avast) bloccano script Python non firmati.

Soluzione: Aggiungi la cartella del progetto alle esclusioni dell'antivirus. In Windows Defender: Impostazioni → Protezione da virus e minacce → Gestisci impostazioni → Esclusioni → Aggiungi cartella.

Problema: pygame non si installa / errori di compilazione

Causa: Manca Visual C++ Build Tools (Windows) o strumenti di sviluppo (Mac/Linux).

Soluzione:

• Windows: Installa "Microsoft Visual C++ Build Tools" da visualstudio.microsoft.com
• Mac: xcode-select --install
• Linux (Ubuntu/Debian): sudo apt install python3-dev libsdl2-dev

Problema: Thonny non apre la finestra grafica di turtle/pygame

Causa: Thonny ha supporto limitato per finestre grafiche esterne.

Soluzione: Passa a VS Code per i Capitoli 7+ (turtle funziona in Thonny ma pygame no). Per turtle in Thonny, assicurati di avere turtle incluso (è nella libreria standard).

Problema: "ModuleNotFoundError: No module named 'pygame'" in VS Code

Causa: VS Code usa un interprete Python diverso da dove hai installato pygame.

Soluzione: Ctrl+Shift+P → "Python: Select Interpreter" → Scegli quello corretto (spesso quello con l'icona della cartella del progetto o quello dove hai fatto pip install pygame).

Checklist Rapida Pre-Capitolo

| Capitolo | IDE | Comando verifica | | ---------- | ----- | ------------------ | | 1-5 | Thonny | print("OK") in Shell | | 6 (turtle) | Thonny o VS Code | import turtle; turtle.forward(10) | | 7-8 (pygame) | VS Code obbligatorio | import pygame; print(pygame.ver) |

Suggerimento Pro: Ambienti Virtuali

Per progetti più seri, usa sempre un ambiente virtuale per isolare le dipendenze:

# Crea ambiente
python -m venv .venv

# Attiva
# Windows:
.venv\Scripts\activate
# Mac/Linux:
source .venv/bin/activate

# Installa dipendenze
pip install pygame

# In VS Code: Ctrl+Shift+P → "Python: Select Interpreter" → Scegli ./venv

Prossimo capitolo

Appendice B: Cheat Sheet Python + Glossario
Tutti i comandi del volume in un foglio: variabili, tipi, controllo flusso, funzioni, liste/dizionari, moduli, file I/O, classi, turtle, pygame — Glossario 25+ termini.

Questo post è un estratto dal libro "Divento Programmatore: Python e i Giochi" (Volume 2 della collana "Cervello Elettronico") di Rocco Balzamà. Target: 10-14 anni · ~180 pagine · Thonny + VS Code.

Per approfondire

• Pong in Python con Pygame: il gioco completo
• Progetto finale in Python: dall'idea al programma
• Snake in Python con Pygame, passo per passo
• Corsi e percorsi di programmazione

Fonti e riferimenti

• Thonny
• Python in Visual Studio Code