Карточки ошибок: перевод с компиляторского

Ошибка компилятора в классических средах — это стена английского текста, от которой новичок закрывает программу. Мы построили поверх неё переводчика: карточку, которая говорит по-русски, что случилось и что делать. Это, пожалуй, самая любимая функция Trema IDE у учителей.

Как выглядит карточка

При ошибке над консолью появляется заметный блок: короткий русский диагноз («похоже, пропущена точка с запятой», «такой команды нет — проверьте название»), совет, что сделать, и ссылка на место в коде — клик переносит редактор к проблемной строке («Клик по ошибке»).

Простейший случай, знакомый каждому: переменную забыли объявить.

void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.println(sensorValue);  // переменная нигде не объявлена
  delay(500);
}

Компилятор сообщает error: 'sensorValue' was not declared in this scope. Карточка над консолью переводит это так: имя sensorValue программе неизвестно — либо переменная не создана, либо в имени опечатка.

Карточки знают оба вида ошибок

• Ошибки сборки — проблемы в коде: опечатки, пропущенные знаки, неизвестные команды, отсутствующие библиотеки.
• Ошибки загрузки — проблемы «дороги»: плата не отвечает, порт занят, выбран не тот вариант платы. Советы здесь практические: проверьте кабель, порт, модель.

Почему это педагогика, а не косметика

Ошибка на понятном языке перестаёт быть стеной и становится задачкой. Ребёнок читает диагноз, кликает, смотрит на строку — и чинит сам. Так воспитывается главный навык инженера: спокойное чтение ошибок. Учителя рассказывают, что поднятых рук на уроке становится вдвое меньше — дети разбираются сами (метод целиком — в «Как читать ошибки»).

А если карточка не распознала ошибку?

Редкие и экзотические ошибки могут прийти без готового диагноза — тогда карточка честно покажет суть, а подробности останутся в полной консоли. Со временем словарь переводчика пополняется: частые непонятные ошибки становятся понятными в следующих версиях программы. Зачем мы вообще взялись переводить машинные сообщения на человеческий язык — объясняет статья «Зачем среде русский язык».

Читайте также

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

• Как читать ошибки