# Усунення несправностей у Tern

## Інсталятор зупиняється

| Повідомлення | Розв'язання |
| --- | --- |
| `This preview requires macOS on Apple Silicon.` | Попередня версія працює лише на Mac з Apple Silicon. |
| `Install Tern and enable its command-line tool before running this installer.` | Додайте команду `tern` до `PATH` і знову запустіть `sh ./install.sh`. |
| `Incomplete release: missing executable dist/elide-tern-…` | Розпакуйте архів заново; спершу перевірте його командою `shasum -a 256 -c SHA256SUMS`. |
| `Incomplete release: runtime, SDK, or plugin is missing.` | Те саме, що вище. |

## Подання не відкривається

| Повідомлення | Розв'язання |
| --- | --- |
| ``The configured runtime has no `elide tern`; update it or set a launcher in plugin/config.json.`` | `runtime` у `plugin/config.json` вказує на Elide без подань Tern. Вкажіть `../runtime/bin/elide` з випуску або видаліть файл і знову запустіть `install.sh`. |
| `Configure plugin/config.json before launching a runtime.` | `plugin/config.json` відсутній або не читається; знову запустіть `install.sh`. |
| `Set the embedded SDK directory in plugin/config.json.` | **Open REPL** потрібен `sdk`; інсталятор задає його як `../sdk`. |
| `Configure a runtime launcher on this host before opening a remote session.` | Подання працюють лише на локальних хостах. Відкрийте проєкт у локальній панелі. |
| `Open a local project directory first.` | Переведіть фокус на панель, каталог якої розташований у проєкті `elide.pkl`. |
| `No elide.pkl found in this directory or its parents.` | Те саме, що вище. |

Якщо шлях до даних плагіна Tern настільки довгий, що перевищує обмеження довжини шляху Unix-сокета, задайте в
`plugin/config.json` для `state` короткий закритий каталог.

## Команда виводить простий текст у Tern

| Причина | Розв'язання |
| --- | --- |
| `elide` з `PATH` не має подань Tern | Перевірте `elide tern --help`; він має виводити `debug`, `project` і `repl`. Установіть Elide 1.6.3 або новіший. |
| `--reporter`, `--project` або шлях до тестів, якого не існує | Очікувано: такі запуски зберігають простий вивід. |
| Вивід перенаправлено або передано через канал | Очікувано. |
| `elide build` поза проєктом `elide.pkl` або з `--inspect`, `--help` чи `--progress` | Очікувано. |
| `elide serve --no-tui` | Очікувано. |

Повний список наведено в розділі [Поверхні термінала](/docs/tern-terminal). Попередження зі згадкою `ELIDE_TERN_SURFACE`
означає, що змінна містить щось інше, ніж `inline`, `screen` або `auto`.

## `elide tern` завершується зі статусом 2

`elide tern repl|project|debug` розміщує подання, які запускає плагін, і поза Tern завершується з кодом `2`.
Використовуйте команди палітри плагіна, а не запускайте його самі.

## Посилання нічого не робить

Посилання `elide://` відкриваються лише через плагін. Для відкинутого посилання показується сповіщення з причиною:

| Сповіщення | Причина |
| --- | --- |
| `Ignored a malformed elide:// link.` | Неправильне кодування, повторений ключ, фрагмент або шлях поза своїм коренем. |
| `Ignored an elide:// link whose root has no elide.pkl.` | `root` не є каталогом проєкту. |
| `Ignored an elide:// link outside a detected project.` | Немає `root`, і файл не входить у жоден проєкт, виявлений цим вікном. |
| `The linked file does not exist.` | Файл переміщено або видалено. |
| `elide:// links open on local hosts only.` | На посилання клацнули у віддаленій панелі. |

Шляхи порівнюються в тому вигляді, в якому написані: посилання на `/tmp/x` не збігається з проєктом у `/private/tmp/x`.

## Редактор вихідного коду

| Симптом | Причина |
| --- | --- |
| Немає підсвічування | У файлі понад 600 рядків. |
| Сповіщення замість тексту | Файл більший за 512 KiB, не читається або не в UTF-8. |
| `Elide source shows JavaScript, TypeScript, Python, Kotlin and Java files.` | Файли інших типів відкриваються в редакторі Tern. |
| Немає накладки **Debug** | Файл не на JavaScript, TypeScript чи Python. |
| Немає накладки **Diagnostics** | Проєкт ще не має звіту про збирання; виконайте `elide build` у терміналі Tern. |
| Усе підсвічування покриття приглушене, `Coverage measured an older version` | Файл змінився після запуску з покриттям; запустіть покриття знову. |

## Налагодження

| Повідомлення | Розв'язання |
| --- | --- |
| `Save this file before debugging.` | Налагоджувач виконує файл із диска. Збережіть, потім запустіть. |
| `Debugging takes JavaScript, TypeScript or Python sources.` | Виберіть підтримуваний файл або скористайтеся вибором цілі. |
| Елементи керування вимкнено з `Take control to drive the target` | Ціллю керує інше подання; виберіть **Take control**. |

## Див. також

- [Усунення несправностей](/docs/troubleshooting) для помилок поза Tern
- [Усунення несправностей OpenTelemetry](/docs/opentelemetry/troubleshooting)