ToolStabil

Velisch Debugger

DAP-kompatibler Debugger für Velisch mit Breakpoints, Variable Inspection und Call Stack Navigation.

Installation

cd tools/debugger
cargo build --release

Verwendung

DAP Server starten

velin-debugger start --port 4711

Der DAP Server lauscht standardmäßig auf Port 4711.

Features

Breakpoints

Setzen und Verwalten von Breakpoints an beliebigen Stellen

Step Over/Into/Out

Schrittweises Debugging durch den Code

Variable Inspection

Variablen im aktuellen Scope anzeigen und analysieren

Call Stack

Vollständige Aufrufkette anzeigen und navigieren

Watch Expressions

Ausdrücke während des Debuggings überwachen

Evaluate

Ausdrücke in der Debug Console evaluieren

DAP Protocol

Der Debugger implementiert das Debug Adapter Protocol (DAP), was bedeutet, dass er mit jedem DAP-kompatiblen Editor funktioniert:

  • VS Code
  • Visual Studio
  • JetBrains IDEs (mit DAP Plugin)
  • Neovim (mit nvim-dap)
  • Emacs (mit dap-mode)

VS Code Integration

Der Debugger ist automatisch in der VS Code Extension integriert. Erstelle eine Launch-Konfiguration:

.vscode/launch.jsonjson
{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "velin",
      "request": "launch",
      "name": "Debug Velisch",
      "program": "${workspaceFolder}/main.velin"
    }
  ]
}

Konfiguration

Port ändern

velin-debugger start --port 5000

VS Code Settings

{
  "velin.debugger.path": "velin-debugger",
  "velin.debugger.port": 4711
}

Troubleshooting

Port bereits belegt

Wenn der Port bereits belegt ist, ändere den Port:

velin-debugger start --port 5000
Debugger startet nicht
  • Prüfe, ob velin-debugger im PATH ist
  • Prüfe die Port-Konfiguration
  • Prüfe Firewall-Einstellungen
Breakpoints werden nicht getroffen
  • Stelle sicher, dass Debug-Informationen generiert wurden
  • Prüfe, ob der Code tatsächlich ausgeführt wird
  • Prüfe, ob die Zeilennummern korrekt sind
LinterHot Reload