VS Code per Python, se qualcosa va storto
Cosa leggi, cosa vuol dire, cosa fai
I guai di VS Code sono quasi tutti silenziosi: niente traceback, niente riga rossa. Un pulsante che manca, un pannello vuoto, una scritta in un angolo. Per questo la tabella parte da quello che vedi.
Prima, il metodo. Se qualcosa non va, controlla in quest'ordine, e fermati alla prima che non torna:
- La cartella. Il nome in cima all'Explorer è quella del progetto?
- Trust. In basso a sinistra c'è scritto
Restricted Mode? - L'interprete. In basso a destra c'è il
.venvdi questo progetto (il percorso sotto il nome, nell'elenco)? - Il terminale. Nato dopo l'interprete? Prompt con
(.venv)? - Le impostazioni.
.vscode/settings.jsondice quello che pensi?
Cosa vedi
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
Restricted Mode in basso a sinistra | VS Code non si fida della cartella: estensioni, debugger e task spenti | Clicca la scritta, poi Trust |
| In basso a destra non c'è nessuna versione di Python, e il ▶ non compare | L'estensione Python non c'è, o è spenta (Restricted Mode, oppure su WSL non è dentro Ubuntu) | Trust; poi Extensions, cerca Python, e su WSL Install in WSL: Ubuntu |
In basso a destra c'è una versione di Python, ma senza .venv | L'interprete è quello del computer, non quello del progetto | Palette dei comandi → Python: Select Interpreter → quello con .venv |
ModuleNotFoundError: No module named 'pytest' premendo ▶ (o un altro nome di libreria), ma nel terminale funziona | L'interprete del ▶ non è il venv che ha quella libreria | Python: Select Interpreter: il .venv del progetto. Il caso lungo: pytest e il venv |
import sottolineati in giallo, ma il programma gira | Lo stesso: l'editor guarda un Python che non ha quel pacchetto | Python: Select Interpreter |
FileNotFoundError: [Errno 2] No such file or directory: 'orari.txt' | Il file c'è, ma il programma parte da un'altra cartella: quella che hai aperto | Guarda il nome in cima all'Explorer, apri la cartella giusta (code . dal progetto) |
Nel progetto ci sono due cartelle .venv e non sai quale è scelta | Due progetti, due venv con lo stesso nome | Apri l'elenco di Select Interpreter: conta il percorso sotto il nome |
Il terminale integrato non ha (.venv) nel prompt | Il terminale è nato prima che scegliessi l'interprete | Cestino, terminale nuovo. Oppure source .venv/bin/activate |
which python dice un Python che non è del progetto | Il venv è spento o è di un altro progetto | deactivate, cd nel progetto giusto, source .venv/bin/activate |
| Il pannello Testing (la provetta) è vuoto | I test non sono configurati, o hai aperto la cartella sbagliata | Cartella giusta, interprete giusto, poi Configure Python Tests → pytest → . Root directory. Poi Refresh Tests |
Il pannello Testing dice No module named pytest | Il .venv scelto non ha pytest | Terminale con il venv acceso, pip install -r requirements.txt, Refresh Tests |
code: command not found (o bash: code: command not found) | Il comando code non è nel PATH | Mac: palette dei comandi → Shell Command: Install 'code' command in PATH. WSL: serve VS Code installato su Windows (non dentro Ubuntu) con l'estensione WSL; riapri il terminale di Ubuntu e riprova |
| Su WSL, in basso a sinistra non c'è WSL: Ubuntu | La finestra è un VS Code di Windows, non collegato a Ubuntu | Chiudila; dal terminale di Ubuntu: cd nel progetto, code . |
| Su WSL, Python c'è ma Ruff (o un'altra estensione) no | È installata solo dal lato Windows | Extensions → l'estensione → Install in WSL: Ubuntu |
There is no formatter for 'python' files installed | Format Document non ha un formattatore per Python | Installa Ruff. Poi Format Document With... → Configure Default Formatter... → Ruff |
| Format Document funziona ma il salvataggio non formatta | Manca editor.formatOnSave, o il formattatore non è impostato per Python | Nel settings.json della cartella: "editor.formatOnSave": true e il blocco "[python]" con editor.defaultFormatter |
Hai modificato settings.json ma non cambia niente | Stai guardando il livello sbagliato: User invece di Workspace (o l'opposto) | Il file della cartella è .vscode/settings.json: quello vince su quello User |
VS Code sottolinea in rosso il settings.json | Un errore di sintassi: una virgola mancante tra due righe, o una virgola in più dopo l'ultima | Passa il mouse sulla sottolineatura. Una virgola tra una riga e la successiva, mai dopo l'ultima |
| Live Share: il compagno non riesce a entrare | Il link è scaduto, la sessione è stata fermata, oppure manca l'accesso con l'account | Rifai Share e manda il link nuovo. Tutti e due devono aver fatto l'accesso in Live Share |
| Live Share: il compagno vede il codice ma non lo fa partire | Il codice gira sul computer di chi condivide | Normale: lo lancia chi condivide. Il compagno guarda e scrive |
Gli errori degli zip, senza traceback
I test di questo capitolo non mostrano il traceback: mostrano una frase.
| Il test dice | Vuol dire | Cosa fai |
|---|---|---|
Non trovo la cartella campo/ | Non hai preparato la missione | bash prepara.sh, dalla cartella della missione |
Manca campo/traccia.txt | Il programma non è mai partito | Apri il file in VS Code, ▶ |
Il programma è partito da una cartella che si chiama «…», ma doveva partire da «campo» | Hai aperto la cartella sbagliata | code campo, poi ▶ |
chi_sono.py lo ha eseguito il venv dell'archivio | Interprete di un altro progetto | Python: Select Interpreter, e guarda il percorso |
Manca campo/.vscode/settings.json | VS Code non ha ancora scritto la configurazione | Configure Python Tests (missione 3) |
settings.json non è un JSON pulito | Un commento, o una virgola in più | Toglili: il test non li accetta |
Il file non è ancora come lo formatta Ruff | Non hai dato Format Document, o non hai salvato | Format Document, poi salva (Cmd+S o Ctrl+S) |
Per non ricascarci
- Prima di cercare nel codice, guarda cartella, interprete e terminale: sono tre cose, e sono nell'angolo dello schermo.
- Apri sempre il progetto con
code .dalla sua cartella. - Quando scegli un interprete, leggi il percorso.
- Tieni un terminale solo, e chiudilo quando cambi interprete.
Altri casi, con i sintomi esatti: il Pronto soccorso. Il prossimo passo: Lanciare i test.