VS-Code-Extension hängt

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

Aktualisiert am 2026-07-13

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 klicken Sie auf das CodeCharter-Statusleisten-Element oder führen CodeCharter: Show language server output in der Kommandopalette aus. Beides öffnet denselben Kanal.

Suchen Sie 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, setzen Sie 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önnen Sie 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 Sie die CLI manuell installiert haben, 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

Enthält Ihr Repository eine codecharter.yml mit deklarierten Profilen, 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üfen Sie das Output-Panel auf [restore]-Zeilen. Warnt die Extension, dass das Lockfile oder der Regel-Cache veraltet ist, nutzen Sie die Aktion "Run restore" in der Benachrichtigung.

6. Extension-Version

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

Vergleichen Sie mit dem aktuellen Release im Portal. Bei einer deutlich älteren Version: VSIX neu installieren. Beachten Sie, 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

[email protected] mit:

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