VS Code per Python
Dire all'editor la cartella, il Python e le regole
- 12 minuti di lettura
Quando un programma «non va in VS Code» ma nel terminale sì, quasi mai è colpa del programma. VS Code ha tre scelte da fare, e le fa da solo, a volte male:
- La cartella che hai aperto.
- L'interprete: il Python che userà per far girare il tuo codice.
- Le impostazioni: le regole di quella cartella (quali test, quale formattatore).
Se ne sbagli una, i sintomi sono strani: la provetta dei test vuota, gli import sottolineati in giallo, un file che «non trova» i suoi dati. Questo capitolo ti insegna dove guardare, in ordine.
Il disegno
Ecco la finestra, con i quattro posti dove guardare. Le scritte sono quelle di VS Code, in inglese.
┌─────────────────────┬────────────────────────────────────────┐
│ EXPLORER │ turni.py [ ▶ ] │
│ │ │
│ ▾ BANCO-VSCODE ◀──┼── 1. la cartella aperta (il nome in │
│ ▸ .venv │ maiuscolo, in cima all'elenco) │
│ ▸ .vscode │ │
│ turni.py │ il codice │
│ ├────────────────────────────────────────┤
│ │ TERMINAL ◀── 4. il terminale integrato │
│ │ (.venv) marta@pc banco-vscode % │
├─────────────────────┴────────────────────────────────────────┤
│ ⌂ WSL: Ubuntu ◀── 2. dove gira VS Code 3.12.13 (.venv) ◀──┤
│ (solo su Windows) 3. l'interprete │
└──────────────────────────────────────────────────────────────┘E le tre scelte, una dopo l'altra: ognuna dipende da quella prima.
la cartella aperta ──▶ l'interprete (il .venv di quella cartella) ──▶ le impostazioni
│ │ │
dove parte il ▶ chi esegue il ▶, .vscode/settings.json
e il terminale i test, Ruff dentro la cartella1 · La cartella giusta
VS Code lavora su una cartella: cerca lì dentro il .venv, i test e le impostazioni. Se apri la cartella sopra o quella sotto, non trova niente, e non ti avvisa.
Il modo più sicuro: dal terminale, entra nella cartella del progetto e scrivi code . (il punto è «questa cartella»).
cd ~/corso/banco-vscode
code .Oppure dal menu: File → Open Folder, e scegli la cartella del progetto.
Come capisci se è giusta. A sinistra, in cima all'Explorer, c'è il nome della cartella aperta, in maiuscolo. Sotto, devi vedere i file del progetto: .venv, requirements.txt, i tuoi .py. Se vedi invece una cartella che contiene tanti progetti, hai aperto quella sopra.
2 · Trust e Restricted Mode
La prima volta che apri una cartella, VS Code ti chiede: «Do you trust the authors of the files in this folder?». Una cartella può contenere programmi, e aprirla con tutte le estensioni accese li farebbe partire. Per questo c'è una domanda.
- Yes, I trust the authors: tutto funziona. La scelta giusta per i tuoi progetti e per gli zip di questo sito.
- No, I don't trust the authors: VS Code resta in Restricted Mode. In basso a sinistra c'è scritto
Restricted Mode.
In Restricted Mode sono spenti il debugger, i task e quasi tutte le estensioni, compresa quella di Python. Il sintomo: l'interprete non si sceglie, il pulsante ▶ non c'è, la provetta non compare. Se vedi la scritta, cliccaci sopra e scegli Trust.
3 · L'interprete
L'interprete è il Python che VS Code usa per eseguire il tuo file, trovare i pacchetti, far girare i test. Può essere diverso da quello del terminale: sono due scelte separate.
Dove si vede. Apri un file .py: in basso a destra, nella barra di stato, c'è scritta una versione di Python (per esempio 3.12.13) e, se è un venv, la parola .venv tra parentesi. Quel pezzo di barra è un pulsante.
Quello giusto è il .venv della cartella che hai aperto. VS Code spesso lo trova da solo, ma controlla sempre: se hai più progetti, ognuno con il suo .venv, il nome è lo stesso e cambia solo il percorso.
Come si cambia.
- Apri la palette dei comandi:
Cmd+Shift+Psu Mac,Ctrl+Shift+Psu Windows/WSL (la finestrella dove scrivi il nome di un comando). - Scrivi Python: Select Interpreter e premi Invio.
- Scegli quello con
.venve guarda il percorso scritto sotto: deve essere quello del tuo progetto. - Non c'è nell'elenco? Enter interpreter path…, poi Find…, e vai a prendere
.venv/bin/pythondentro il progetto.
La palette dei comandi serve per tutto: se non sai dove sta un'opzione, scrivi il suo nome lì.
Il venv, cos'è e come si crea, è nel capitolo Il venv e pip. Se l'interprete è sbagliato e i test non partono, il caso lungo è nel Pronto soccorso.
4 · Il terminale integrato
Il terminale che hai già usato, dentro VS Code: View → Terminal. La scorciatoia è Ctrl più l'apice rovesciato, ma sulla tastiera italiana è scomodo: il menu va benissimo.
- Si apre nella cartella che hai aperto: per questo la cartella giusta conta già qui.
- Accende il venv da solo. Con l'impostazione
python.terminal.activateEnvironment(accesa di default), un terminale nuovo parte con il prompt che inizia con(.venv). - Solo i terminali nuovi. Se il terminale era già aperto quando hai scelto l'interprete, resta com'era: chiudilo con il cestino e aprine uno.
which python
echo $VIRTUAL_ENV/Users/marta/corso/banco-vscode/.venv/bin/python
/Users/marta/corso/banco-vscode/.venv(Su WSL: /home/marta/corso/banco-vscode/.venv/....) Se which python dice un'altra cosa, o $VIRTUAL_ENV è vuoto, il venv è spento: source .venv/bin/activate.
5 · Il pulsante ▶
In alto a destra, nel file .py, c'è un triangolo: Run Python File. Fa questo, e niente di più:
- apre un terminale (quello integrato) nella cartella che hai aperto;
- ci scrive il comando: interprete scelto + percorso del file, e lo lancia.
Cioè: /…/.venv/bin/python /…/turni.py, dalla cartella aperta. Da qui vengono i due errori che vedrai più spesso: l'interprete sbagliato (ModuleNotFoundError) e la cartella sbagliata (FileNotFoundError per un file di dati che il programma cerca «qui accanto»).
6 · Le estensioni
VS Code da solo sa scrivere testo. Tutto il resto lo fanno le estensioni, che si cercano nel pannello Extensions (i quadratini nella barra a sinistra). Per questo libro ne bastano tre.
| Estensione | A cosa serve | Id (per cercarla) |
|---|---|---|
| Python (Microsoft) | l'interprete, il ▶, i test, il debugger. Senza, un .py è solo testo | ms-python.python |
| Ruff (Astral) | formatta il codice e lo controlla mentre scrivi | charliermarsh.ruff |
| Live Share (Microsoft) | lavorare insieme a un compagno sullo stesso progetto | ms-vsliveshare.vsliveshare |
Su Windows con WSL le estensioni vanno installate due volte. VS Code ha una parte su Windows (la finestra) e una dentro Ubuntu (dove stanno i tuoi file e il Python): un'estensione installata solo da una parte non vede l'altra. Come capisci dove sei: in basso a sinistra, nell'angolino verde, deve esserci WSL: Ubuntu. Poi, nel pannello Extensions, accanto a Python e a Ruff può comparire il pulsante Install in WSL: Ubuntu: cliccalo.
Se la scritta WSL: Ubuntu non c'è: chiudi VS Code, apri il terminale di Ubuntu, cd nella cartella del progetto e scrivi code ..
7 · settings.json
Le impostazioni sono un file di testo, settings.json. Ne esistono due livelli:
| Livello | Dove sta | Vale per |
|---|---|---|
| User | nella cartella delle impostazioni di VS Code, nel tuo computer | tutti i progetti |
| Workspace (la cartella) | .vscode/settings.json dentro il progetto | solo quel progetto, e vince sull'altro |
Per aprirli: palette dei comandi → Preferences: Open User Settings (JSON) oppure Preferences: Open Workspace Settings (JSON). Oppure la finestra grafica, Cmd+, su Mac e Ctrl+, su Windows/WSL, con le schede User e Workspace: ogni casella che cambi scrive una riga nel file.
Un esempio vero: quando configuri i test dal pannello Testing, VS Code scrive questo in .vscode/settings.json.
{
"python.testing.pytestArgs": [
"."
],
"python.testing.unittestEnabled": false,
"python.testing.pytestEnabled": true
}Sono tre righe: «i test si cercano nella cartella aperta (.)», «non usare unittest», «usa pytest». Il file è JSON: chiavi tra virgolette, due punti, una virgola tra una riga e l'altra, nessuna dopo l'ultima.
Il file .vscode/ dentro uno zip di questo sito è già pronto: usa il .venv della cartella e trova i test. Se un progetto non ce l'ha, lo scrivi tu.
8 · Ruff
Ruff mette in ordine il codice: virgolette sempre uguali, spazi al posto giusto, le righe troppo lunghe spezzate. Non cambia cosa fa il programma, solo come si legge.
- Format Document: formatta il file aperto. Tasto destro nel file, oppure
Shift+Option+Fsu Mac,Shift+Alt+Fsu Windows/WSL. La prima volta VS Code può chiederti quale formattatore usare: scegli Ruff. - Al salvataggio: con due impostazioni, il file si formatta da solo a ogni salvataggio.
{
"editor.formatOnSave": true,
"[python]": {
"editor.defaultFormatter": "charliermarsh.ruff"
}
}La prima dice «formatta quando salvi». La seconda, dentro il blocco [python] (le regole solo per i file Python), dice chi formatta: Ruff.
9 · Live Share
Con Live Share un compagno vede il tuo progetto, nel suo VS Code, e puoi anche farlo scrivere con te, come in un documento condiviso.
- Installa l'estensione, poi clicca Live Share nella barra in basso (o l'icona nella barra a sinistra) e fai l'accesso con il tuo account.
- Premi Share: VS Code copia un link negli appunti. Mandalo al compagno.
- Il compagno incolla il link nel suo browser, o usa Join in Live Share. Vede i tuoi file e il punto in cui scrivi, e può scrivere anche lui.
- Per smettere: Stop Collaboration Session.
Chi condivide mette il computer: i file, il Python e il venv sono i suoi. Il compagno vede e modifica, ma il codice gira da te. Condividi solo con persone che conosci.
Ricorda
- VS Code fa tre scelte: la cartella, l'interprete, le impostazioni. Se qualcosa non va, controllale in quest'ordine.
code .dalla cartella del progetto è il modo più sicuro per aprirla.- Restricted Mode in basso a sinistra: cliccaci e scegli Trust.
- L'interprete si legge in basso a destra: deve essere il
.venvdi quella cartella, e si cambia con Python: Select Interpreter. - Il terminale integrato e il ▶ partono dalla cartella aperta. Il terminale già aperto non si accorge dell'interprete nuovo: chiudilo e riaprilo.
- Su WSL: WSL: Ubuntu in basso a sinistra, e le estensioni con Install in WSL: Ubuntu.
.vscode/settings.jsonè il file delle impostazioni del progetto: è JSON, niente commenti per i programmi che lo leggono.