База знаний · Ошибки и решения

Как читать ошибки: короткий метод

Ошибка — это не приговор, а подсказка. Разбираем, как устроены сообщения и с чего начинать.

Ошибка — это не «всё сломалось», а подсказка: программа сообщает, что именно ей не понравилось и где. Научиться читать эти подсказки — самый полезный навык новичка. В Trema IDE это проще, чем где-либо: ошибки объясняются по-русски, карточками, с переходом к нужной строке.

Первый вопрос: сборка или загрузка?

Все ошибки делятся на два семейства, и лечатся они по-разному:

  • Ошибка сборки — проблема в коде: опечатка, пропущенный знак, неизвестная команда, нет библиотеки. Программа даже не собралась — плата ни при чём.
  • Ошибка загрузки — код в порядке, но не удалось передать его в плату: кабель, порт, драйвер, не та плата в списке.

Trema IDE сама показывает, на каком этапе случилась беда, — по этапам прогресса и тексту карточки.

Карточка ошибки сборки в Trema IDE: объяснение по-русски и переход к строке кода
Карточка над консолью: что случилось, почему и где. Клик — и редактор на нужной строке.

Разберём на живом примере. В этом скетче одна-единственная опечатка — в конце второй строки не хватает точки с запятой:

void setup() {
  pinMode(LED_BUILTIN, OUTPUT)   // ← здесь забыта точка с запятой
  Serial.begin(9600);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(500);
  digitalWrite(LED_BUILTIN, LOW);
  delay(500);
}

Компилятор отвечает так: error: expected ';' before 'Serial' — и указывает третью строку, хотя ошибка во второй. Это не издевательство: компилятор дочитал вторую строку, не увидел точки с запятой и споткнулся уже о следующее слово. Поэтому правило первое: увидели ошибку в строке N — смотрите и строку N−1.

Метод из трёх шагов

  1. Прочитайте карточку. Не консоль, а именно карточку — она уже перевела суть на русский.
  2. Кликните по ней. Редактор перепрыгнет к строке, где компилятор споткнулся. Важно: иногда сама опечатка — строкой выше (например, там забыта точка с запятой).
  3. Исправьте одно и соберите снова. Не правьте десять мест сразу: одна правка — одна проверка. Так вы точно поймёте, что помогло.

Куда идти с конкретной ошибкой

Разбор типовых сообщений компилятора — «expected ;», «was not declared», «No such file or directory» — собран на странице «Ошибки: как читать и чинить». А в этом разделе базы знаний — статьи про всё остальное: плата не видна, прошивка не идёт, кракозябры в мониторе и другие сюжеты.

Совет учителям и родителям

Не спешите чинить за ребёнка. Попросите его прочитать карточку вслух и сказать своими словами, что программа просит. В девяти случаях из десяти ребёнок найдёт и исправит ошибку сам — а это и есть обучение программированию.

Частые вопросы

Чем ошибка сборки отличается от ошибки загрузки?

Ошибка сборки — проблема в коде: программа даже не собралась. Ошибка загрузки — код в порядке, но не удалось передать его в плату: кабель, порт, драйвер.

Обновлено: 19 июля 2026