VS-Code-Extension hängt

Wenn der Language Server für die DSL nicht startet oder Autovervollständigung fehlt.

Aktualisiert am 2026-09-01

Häufige Symptome bei der VS Code Extension für .ccr-Dateien:

Keine Autovervollständigung der Schema-Properties.
Das Statusleisten-Element zeigt ein Fehlersymbol neben "CodeCharter"; beim Überfahren mit der Maus erscheinen Details wie "serverPath not set and CLI not found in PATH".
CodeCharter: Analyze workspace (.sln/.csproj) schlägt fehl mit der Meldung "CodeCharter CLI not found. Set "codecharter.serverPath" in settings."

Hinweis: Das Syntax-Highlighting für .ccr-Dateien kommt aus der Extension selbst und funktioniert auch dann, wenn der Language Server nicht läuft. Fehlt das Highlighting, ist die Extension nicht installiert oder nicht aktiv, das ist ein anderes Problem.

Hier die übliche Reihenfolge zum Debuggen.

1. Output-Panel öffnen

View → Output, im Dropdown "CodeCharter" auswählen. Hier stehen der Aufruf der CLI und alle LSP-Meldungen. Alternativ wählt ihr das CodeCharter-Statusleisten-Element oder führt CodeCharter: Show language server output in der Kommandopalette aus. Beides öffnet denselben Kanal.

Sucht nach:

[lsp] starting: <Pfad> lsp mit dem aufgelösten CLI-Pfad
[lsp] start failed: ... oder Stderr-Ausgaben der CLI
[activate] resolved serverPath = <none>, wenn keine CLI gefunden wurde

2. CLI-Verfügbarkeit prüfen

Wenn codecharter.serverPath nicht gesetzt ist, sucht die Extension im PATH nach codecharter, CodeCharter.Cli und CodeCharter.Cli.exe. Wenn das nicht funktioniert:

codecharter --version

Wenn das "command not found" ergibt, setzt ihr codecharter.serverPath in den VS Code Settings auf den vollen Pfad. Der Wert unterstützt die Variablen ${workspaceFolder} und ${userHome}:

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

oder unter Windows (die Standard-Installation pro Benutzer landet in %LOCALAPPDATA%\Programs\CodeCharter, eine Installation mit Administratorrechten für alle Benutzer in C:\Program Files\CodeCharter):

{
  "codecharter.serverPath": "${userHome}\\AppData\\Local\\Programs\\CodeCharter\\codecharter.exe"
}

Unter Windows könnt ihr auch den Installer erneut ausführen: Er kann die VS-Code-Extension installieren und codecharter.serverPath automatisch setzen.

3. Rechte unter Linux und macOS

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

chmod +x /opt/codecharter/codecharter

Das Output-Panel zeigt in diesem Fall typischerweise eine Permission-Denied-Meldung.

4. Language Server neu starten

In der Kommandopalette: CodeCharter: Restart language server.

5. `codecharter restore` beim Start prüfen

Deklariert die .codecharter/config.yml eures Repositorys Profile, führt die Extension beim Aktivieren zuerst codecharter restore aus, bevor der Language Server startet. Ein langsames oder fehlschlagendes Restore kann wie ein Hänger wirken. Prüft das Output-Panel auf [restore]-Zeilen. Warnt die Extension, dass das Lockfile oder der Regel-Cache veraltet ist, nutzt die Aktion "Run restore" in der Benachrichtigung.

6. Extension-Version

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

Vergleicht mit dem aktuellen Release im Portal. Bei einer deutlich älteren Version: VSIX neu installieren. Beachtet, dass die Extension VS Code 1.85 oder neuer voraussetzt; auf einem älteren VS Code lässt sich das VSIX gar nicht erst installieren.

7. Trace aktivieren

Für detaillierten LSP-Verkehr:

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

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

Wenn nichts hilft

support@codecharter.tools mit:

VS Code Version
CodeCharter Extension Version
CodeCharter CLI Version (codecharter --version)
Output-Panel-Logs als Anhang
Betriebssystem und Architektur