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

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:

  1. La cartella. Il nome in cima all'Explorer è quella del progetto?
  2. Trust. In basso a sinistra c'è scritto Restricted Mode?
  3. L'interprete. In basso a destra c'è il .venv di questo progetto (il percorso sotto il nome, nell'elenco)?
  4. Il terminale. Nato dopo l'interprete? Prompt con (.venv)?
  5. Le impostazioni. .vscode/settings.json dice quello che pensi?

Cosa vedi

LeggiVuol direCosa fai
Restricted Mode in basso a sinistraVS Code non si fida della cartella: estensioni, debugger e task spentiClicca la scritta, poi Trust
In basso a destra non c'è nessuna versione di Python, e il ▶ non compareL'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 .venvL'interprete è quello del computer, non quello del progettoPalette dei comandi → Python: Select Interpreter → quello con .venv
ModuleNotFoundError: No module named 'pytest' premendo ▶ (o un altro nome di libreria), ma nel terminale funzionaL'interprete del ▶ non è il venv che ha quella libreriaPython: Select Interpreter: il .venv del progetto. Il caso lungo: pytest e il venv
import sottolineati in giallo, ma il programma giraLo stesso: l'editor guarda un Python che non ha quel pacchettoPython: 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 apertoGuarda il nome in cima all'Explorer, apri la cartella giusta (code . dal progetto)
Nel progetto ci sono due cartelle .venv e non sai quale è sceltaDue progetti, due venv con lo stesso nomeApri l'elenco di Select Interpreter: conta il percorso sotto il nome
Il terminale integrato non ha (.venv) nel promptIl terminale è nato prima che scegliessi l'interpreteCestino, terminale nuovo. Oppure source .venv/bin/activate
which python dice un Python che non è del progettoIl venv è spento o è di un altro progettodeactivate, cd nel progetto giusto, source .venv/bin/activate
Il pannello Testing (la provetta) è vuotoI test non sono configurati, o hai aperto la cartella sbagliataCartella giusta, interprete giusto, poi Configure Python Tests → pytest → . Root directory. Poi Refresh Tests
Il pannello Testing dice No module named pytestIl .venv scelto non ha pytestTerminale 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 PATHMac: 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: UbuntuLa finestra è un VS Code di Windows, non collegato a UbuntuChiudila; dal terminale di Ubuntu: cd nel progetto, code .
Su WSL, Python c'è ma Ruff (o un'altra estensione) noÈ installata solo dal lato WindowsExtensions → l'estensione → Install in WSL: Ubuntu
There is no formatter for 'python' files installedFormat Document non ha un formattatore per PythonInstalla Ruff. Poi Format Document With... → Configure Default Formatter... → Ruff
Format Document funziona ma il salvataggio non formattaManca editor.formatOnSave, o il formattatore non è impostato per PythonNel settings.json della cartella: "editor.formatOnSave": true e il blocco "[python]" con editor.defaultFormatter
Hai modificato settings.json ma non cambia nienteStai 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.jsonUn errore di sintassi: una virgola mancante tra due righe, o una virgola in più dopo l'ultimaPassa il mouse sulla sottolineatura. Una virgola tra una riga e la successiva, mai dopo l'ultima
Live Share: il compagno non riesce a entrareIl link è scaduto, la sessione è stata fermata, oppure manca l'accesso con l'accountRifai 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 partireIl codice gira sul computer di chi condivideNormale: 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 diceVuol direCosa fai
Non trovo la cartella campo/Non hai preparato la missionebash prepara.sh, dalla cartella della missione
Manca campo/traccia.txtIl programma non è mai partitoApri il file in VS Code, ▶
Il programma è partito da una cartella che si chiama «…», ma doveva partire da «campo»Hai aperto la cartella sbagliatacode campo, poi ▶
chi_sono.py lo ha eseguito il venv dell'archivioInterprete di un altro progettoPython: Select Interpreter, e guarda il percorso
Manca campo/.vscode/settings.jsonVS Code non ha ancora scritto la configurazioneConfigure Python Tests (missione 3)
settings.json non è un JSON pulitoUn commento, o una virgola in piùToglili: il test non li accetta
Il file non è ancora come lo formatta RuffNon hai dato Format Document, o non hai salvatoFormat 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.