Come posso configurare il debugging passo-passo per gli script Octave in Visual Studio Code

Per eseguire il debugging passo-passo degli script Octave in Visual Studio Code puoi utilizzare l'estensione Octave Debugger accoppiata a un file di configurazione launch.json, oppure ricorrere alle direttive di debug native di Octave dal terminale integrato.

Metodo 1: Debug Grafico con l'estensione VS Code (Consigliato)

1. Installare l'estensione

1. Apri la sezione Estensioni in VS Code (Ctrl + Shift + X).

2. Cerca e installa Octave Debugger (sviluppata da rajasuleman o Tamas K. Kovacs).

2. Configurare launch.json

Per indicare a VS Code come lanciare Octave in modalità debug:

1. Vai nella vista Run and Debug nella barra laterale sinistra (Ctrl + Shift + D).

2. Fai clic su create a launch.json file e seleziona Octave (oppure crea manualmente la cartella .vscode e il file launch.json nel tuo progetto).

3. Inserisci la seguente configurazione:

JSON

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Script Octave",
      "type": "octave",
      "request": "launch",
      "program": "${file}",
      "octaveExecutable": "octave-cli",
      "terminalKind": "integrated"
    }
  ]
}

3. Avviare il debugging

1. Apri lo script .m che desideri analizzare.

2. Imposta uno o più punti di interruzione (Breakpoints) facendo clic sul margine sinistro a fianco del numero di riga (comparirà un pallino rosso).

3. Premi F5 per avviare il debugger.

4. Utilizza i controlli di debug in alto o le scorciatoie da tastiera:

   • F10 (Step Over): Esegue la riga corrente e passa alla successiva.

   • F11 (Step Into): Entra all'interno della funzione richiamata nella riga.

   • Shift + F11 (Step Out): Esce dalla funzione corrente e torna al chiamante.

   • F5 (Continue): Prosegue l'esecuzione fino al breakpoint successivo o alla fine dello script.

   • Pannello delle Variabili: Nella barra laterale sinistra potrai ispezionare il valore di tutte le variabili locali e globali in tempo reale ad ogni passo.

Metodo 2: Debugger Nativo da Terminale (Senza Estensioni)

Se preferisci non installare estensioni aggiuntive per il debug, puoi usare gli strumenti nativi di Octave all'interno del terminale integrato di VS Code (Ctrl + `).

1. Inserire punti di interruzione via codice

Aggiungi l'istruzione keyboard nel punto del file .m dove vuoi che l'esecuzione si interrompa:

Snippet di codice

x = 1:10;
y = x .^ 2;

keyboard; % L'esecuzione si ferma qui

z = y + 5;

2. Eseguire lo script

Nel terminale di VS Code esegui lo script:

Bash

octave-cli mio_script.m

Quando il codice raggiunge keyboard, il prompt cambierà in debug> . Da questo momento puoi inserire i comandi di controllo:

Comando
Azione

dbstep
Avanza di una riga (Step Over)

dbstep in
Entra nella funzione (Step Into)

dbcont
Continua l'esecuzione fino al termine o al successivo punto di arresto

dbquit
Interrompe la sessione di debugging ed esce

nome_variabile
Scrivi il nome di qualsiasi variabile per stampare il suo valore corrente