Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Il banco di lavoro3. VS Code per Pythonp. 57

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:

  1. La cartella che hai aperto.
  2. L'interprete: il Python che userà per far girare il tuo codice.
  3. 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 cartella

1 · 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»).

Terminale
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.

  1. Apri la palette dei comandi: Cmd+Shift+P su Mac, Ctrl+Shift+P su Windows/WSL (la finestrella dove scrivi il nome di un comando).
  2. Scrivi Python: Select Interpreter e premi Invio.
  3. Scegli quello con .venv e guarda il percorso scritto sotto: deve essere quello del tuo progetto.
  4. Non c'è nell'elenco? Enter interpreter path…, poi Find…, e vai a prendere .venv/bin/python dentro 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.
Terminale
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ù:

  1. apre un terminale (quello integrato) nella cartella che hai aperto;
  2. 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.

EstensioneA cosa serveId (per cercarla)
Python (Microsoft)l'interprete, il ▶, i test, il debugger. Senza, un .py è solo testoms-python.python
Ruff (Astral)formatta il codice e lo controlla mentre scrivicharliermarsh.ruff
Live Share (Microsoft)lavorare insieme a un compagno sullo stesso progettoms-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:

LivelloDove staVale per
Usernella cartella delle impostazioni di VS Code, nel tuo computertutti i progetti
Workspace (la cartella).vscode/settings.json dentro il progettosolo 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.

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+F su Mac, Shift+Alt+F su 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.
JSON
{
    "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.

  1. 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.
  2. Premi Share: VS Code copia un link negli appunti. Mandalo al compagno.
  3. 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.
  4. 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 .venv di 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.