# Fehlerbehebung in Tern

## Das Installationsprogramm bricht ab

| Meldung | Lösung |
| --- | --- |
| `This preview requires macOS on Apple Silicon.` | Die Vorschau läuft nur auf Macs mit Apple Silicon. |
| `Install Tern and enable its command-line tool before running this installer.` | Legen Sie den Befehl `tern` in den `PATH` und führen Sie `sh ./install.sh` erneut aus. |
| `Incomplete release: missing executable dist/elide-tern-…` | Entpacken Sie das Archiv erneut; prüfen Sie es vorher mit `shasum -a 256 -c SHA256SUMS`. |
| `Incomplete release: runtime, SDK, or plugin is missing.` | Wie oben. |

## Eine Ansicht öffnet sich nicht

| Meldung | Lösung |
| --- | --- |
| ``The configured runtime has no `elide tern`; update it or set a launcher in plugin/config.json.`` | `runtime` in `plugin/config.json` verweist auf ein Elide ohne Tern-Ansichten. Lassen Sie es auf `../runtime/bin/elide` des Release zeigen, oder löschen Sie die Datei und führen Sie `install.sh` erneut aus. |
| `Configure plugin/config.json before launching a runtime.` | `plugin/config.json` fehlt oder ist nicht lesbar; führen Sie `install.sh` erneut aus. |
| `Set the embedded SDK directory in plugin/config.json.` | **Open REPL** benötigt `sdk`; das Installationsprogramm setzt es auf `../sdk`. |
| `Configure a runtime launcher on this host before opening a remote session.` | Ansichten laufen nur auf lokalen Hosts. Öffnen Sie das Projekt in einem lokalen Bereich. |
| `Open a local project directory first.` | Fokussieren Sie einen Bereich, dessen Verzeichnis in einem `elide.pkl`-Projekt liegt. |
| `No elide.pkl found in this directory or its parents.` | Wie oben. |

Ist Terns Plugin-Datenpfad so lang, dass er die Pfadlängengrenze für Unix-Sockets überschreitet, setzen Sie `state` in
`plugin/config.json` auf ein kurzes privates Verzeichnis.

## Ein Befehl gibt in Tern Klartext aus

| Ursache | Lösung |
| --- | --- |
| Das `elide` im `PATH` hat keine Tern-Ansichten | Prüfen Sie `elide tern --help`; es muss `debug`, `project` und `repl` auflisten. Installieren Sie Elide 1.6.3 oder neuer. |
| `--reporter`, `--project` oder ein nicht existierender Testpfad | Erwartet: Diese Läufe behalten die Textausgabe. |
| Umgeleitete oder weitergeleitete Ausgabe | Erwartet. |
| `elide build` außerhalb eines `elide.pkl`-Projekts oder mit `--inspect`, `--help` oder `--progress` | Erwartet. |
| `elide serve --no-tui` | Erwartet. |

Die vollständige Liste steht unter [Terminal-Oberflächen](/docs/tern-terminal). Eine Warnung, die `ELIDE_TERN_SURFACE`
nennt, bedeutet, dass die Variable etwas anderes als `inline`, `screen` oder `auto` enthält.

## `elide tern` endet mit Status 2

`elide tern repl|project|debug` hostet die Ansichten, die das Plugin startet, und endet außerhalb von Tern mit `2`.
Verwenden Sie die Palettenbefehle des Plugins, statt es selbst auszuführen.

## Ein Link tut nichts

`elide://`-Links öffnen sich nur über das Plugin. Ein verworfener Link zeigt eine Benachrichtigung mit dem Grund:

| Benachrichtigung | Ursache |
| --- | --- |
| `Ignored a malformed elide:// link.` | Fehlerhafte Kodierung, ein wiederholter Schlüssel, ein Fragment oder ein Pfad außerhalb seines Stamms. |
| `Ignored an elide:// link whose root has no elide.pkl.` | `root` ist kein Projektverzeichnis. |
| `Ignored an elide:// link outside a detected project.` | Kein `root`, und die Datei liegt in keinem Projekt, das dieses Fenster erkannt hat. |
| `The linked file does not exist.` | Die Datei wurde verschoben oder gelöscht. |
| `elide:// links open on local hosts only.` | Der Link wurde in einem entfernten Bereich angeklickt. |

Pfade werden so verglichen, wie sie geschrieben sind: Ein Link auf `/tmp/x` passt nicht zu einem Projekt unter
`/private/tmp/x`.

## Der Quelltext-Editor

| Symptom | Ursache |
| --- | --- |
| Keine Hervorhebung | Die Datei hat mehr als 600 Zeilen. |
| Ein Hinweis statt des Texts | Die Datei ist größer als 512 KiB, nicht lesbar oder nicht UTF-8. |
| `Elide source shows JavaScript, TypeScript, Python, Kotlin and Java files.` | Andere Dateitypen öffnen sich in Terns Editor. |
| Kein Overlay **Debug** | Die Datei ist kein JavaScript, TypeScript oder Python. |
| Kein Overlay **Diagnostics** | Das Projekt hat noch keinen Build-Bericht; führen Sie `elide build` in einem Tern-Terminal aus. |
| Alle Abdeckungsfärbungen gedämpft, `Coverage measured an older version` | Die Datei hat sich seit dem Abdeckungslauf geändert; führen Sie die Abdeckung erneut aus. |

## Debugging

| Meldung | Lösung |
| --- | --- |
| `Save this file before debugging.` | Der Debugger führt die Datei auf der Festplatte aus. Speichern, dann starten. |
| `Debugging takes JavaScript, TypeScript or Python sources.` | Wählen Sie eine unterstützte Datei oder verwenden Sie die Zielauswahl. |
| Steuerelemente deaktiviert mit `Take control to drive the target` | Eine andere Ansicht steuert das Ziel; wählen Sie **Take control**. |

## Siehe auch

- [Fehlerbehebung](/docs/troubleshooting) für Fehler außerhalb von Tern
- [Fehlerbehebung für OpenTelemetry](/docs/opentelemetry/troubleshooting)