Debugging Code

Funktionen

• Setzen von Breakpoints (bedingt, bei Ausnahmen)
• Schrittweises Ausführen von Code (Zeile für Zeile, hinein, hinaus, darüber)
• Inspektion des Live-Variablenzustands und des Call Stack
• Auswertung beliebiger Ausdrücke gegen das laufende Programm
• Anhängen an laufende Prozesse oder Remote-Debugger

Anwendungsfälle

• Verwenden, wenn ein Programm abstürzt oder unerwartete Ausnahmen auslöst.
• Verwenden, wenn die Ausgabe falsch ist und Print-Statement-Debugging nicht ausreicht.
• Verwenden, um zu verstehen, wie die Ausführung in komplexem Code einen bestimmten Zustand erreicht hat.
• Verwenden, um Ursachen durch schrittweises Ausführen und Inspektion von Variablen zu verfolgen.

Nicht-Ziele

• Automatisierte Code-Korrektur oder -Patching.
• Statische Code-Analyse oder Linting.
• Bereitstellung oder Testen von Anwendungen.

Workflow

1. Der Benutzer identifiziert einen Fehler oder muss den Ausführungsfluss verstehen.
2. Der Benutzer ruft die Erweiterung mit `dap debug <Datei>` auf und gibt optional Breakpoints an.
3. Die Erweiterung startet das Programm unter dem Debugger über die `dap`-CLI.
4. Die Programmausführung stoppt an Breakpoints oder beim Eintritt.
5. Der Benutzer interagiert mit dem Debugger mit Befehlen wie `step`, `eval`, `inspect`, um den Zustand zu erkunden.
6. Der Benutzer setzt die Ausführung fort oder hängt sich an einen laufenden Prozess.
7. Der Benutzer überprüft Korrekturen, indem er das debuggte Programm erneut ausführt oder neu startet.
8. Die Sitzung wird über `dap stop` oder automatisch beendet.

Praktiken

• Debugging-Workflow
• Interaktive Ausführung
• Zustandsinspektion

Voraussetzungen

• Die `dap`-CLI muss installiert sein.
• Ein kompatibler Debugger-Backend für die Zielsprache muss installiert sein.
• Das Zielprogramm muss vom Debugger startbar oder ankoppelbar sein.