VS-Code-Extension hängt

Häufige Symptome bei der VS Code Extension für .cgr-Files:

• Keine Syntax-Highlighting auf einer geöffneten .cgr-Datei.
• Keine Autovervollständigung der Schema-Properties.
• Status-Bar zeigt "serverPath not found" oder einen Fehler.
• CodeGuard: Analyze workspace macht nichts.

Hier die übliche Reihenfolge zum Debug.

1. Output-Panel öffnen

View → Output, im Dropdown "CodeGuard" auswählen. Hier steht der Aufruf der CLI und alle LSP-Meldungen.

Sucht nach:

• "Spawning codeguard..." mit Pfad und Args
• Stderr-Ausgaben der CLI
• "serverPath not found"

2. CLI-Verfügbarkeit prüfen

Die Extension nutzt per Default die codeguard-CLI aus dem PATH. Wenn das nicht funktioniert:

codeguard --version

Wenn das "command not found" gibt, setz codeguard.serverPath in den VS Code Settings auf den vollen Pfad:

{
  "codeguard.serverPath": "/usr/local/bin/codeguard"
}

oder unter Windows:

{
  "codeguard.serverPath": "C:\\Program Files\\CodeGuard\\codeguard.exe"
}

3. Rechte unter Linux und macOS

Wenn ihr die CLI manuell installiert habt, vergisst man manchmal das Execute-Bit:

chmod +x /opt/codeguard/codeguard

Das Output-Panel zeigt dann typisch eine Permission-Denied-Meldung.

4. Language Server neu starten

In der Kommandopalette: CodeGuard: Restart language server.

5. Extension-Version

code --list-extensions --show-versions | grep -i codeguard

Vergleich mit dem aktuellen Release im Portal. Bei einer deutlich älteren Version: VSIX neu installieren.

6. Trace aktivieren

Für detaillierten LSP-Verkehr:

{
  "codeguard.trace.server": "verbose"
}

Danach Output-Panel öffnen und das LSP-Log durchgehen.

Wenn nichts hilft

[email protected] mit:

• VS Code Version
• CodeGuard Extension Version
• CodeGuard CLI Version (codeguard --version)
• Output-Panel-Logs als Anhang
• Betriebssystem und Architektur