Ошибки компиляции Arduino

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

Сообщения печатает компилятор C++, и он пишет по-английски. Trema IDE переводит суть: над консолью появляется русская карточка — что случилось, в каком файле и в какой строке. Клик по карточке приводит к месту проблемы.

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

Навигатор: нашли фразу — идите в раздел

Сообщений компилятора сотни, но в школьной и кружковой практике встречается десяток. Найдите свою строку и нажмите на неё — откроется нужный раздел этой страницы.

Ошибки вокруг экранов разобраны отдельно: LCD 1602 по I2C (одноимённые библиотеки, begin() против init(), #error из русской библиотеки) и OLED SSD1306 («allocation failed» при зелёной сборке). Про цветные экраны — TFT-дисплеи (Adafruit_GFX.h без BusIO, begin() вместо initR(), TFT_eSPI на 107 % флеша).

Что ломается чаще всего

За месяц наблюдений (24 июля — 21 августа 2026) мы собрали обезличенную статистику ошибок сборки — несколько тысяч сообщений. Картина получилась неожиданная: ненайденная библиотека встречается чаще, чем все настоящие ошибки в коде вместе взятые — 38 % против 28 %.

Главный вывод для новичка: самая частая строка в отчётах — не опечатка, а ненайденная библиотека, 38 % всех случаев. Поэтому разбор стоит начинать со строки #include, а не с поиска опечаток в своём коде.

'x' does not name a type

Пятая по частоте ошибка и при этом самая «немая»: компилятор говорит, что слово в начале строки для него не тип данных. Причин у неё три:

• Опечатка в типе. Живые примеры: vold setup() вместо void, liquidCristal вместо LiquidCrystal. Компилятор часто сам предлагает правильное слово — читайте хвост сообщения did you mean.
• Сломана строка выше. Компилятор читает текст подряд: если в предыдущей строке потерялась точка с запятой или закрывающая скобка, «не типом» окажется первое слово следующей строки — хоть void, хоть имя вашей функции. Смотрите на строку выше указанной.
• Тип из библиотеки, которая не подключена. Объявление Wire, TFT_ILI9341 или BluetoothSerial стоит выше строки #include — или библиотека не установлена вовсе. Подключение всегда идёт первым.

А вот забытая точка с запятой после описания класса или структуры даёт другое сообщение, и оно понятнее: expected ';' after struct definition. Номер строки при этом указывает на закрывающую фигурную скобку.

И отдельно про частый совет из интернета: строка setup() { без слова void даёт вовсе не это сообщение, а expected constructor, destructor, or type conversion и следом ambiguating new declaration of 'int setup()'. Лечится одинаково — вернуть void на место.

Compilation error: exit status 1

Эта строка стоит в самом конце и не объясняет ничего: так среда сообщает, что инструмент сборки завершился неудачей. Ноль — успех, любое другое число — нет, и какое именно, роли не играет: встречается и exit status 2. Причина всегда выше, в первой строке со словом error:. Пролистайте консоль вверх.

В разных средах строка выглядит по-разному: Arduino IDE пишет Compilation error: exit status 1, а Trema IDE и командная строка — Ошибка во время сборки: exit status 1. Смысл один и тот же. Отдельный случай — когда программа не влезает во флеш-память: тогда в конце стоит секция текста превышает доступное пространство на плате, и это уже вопрос размера, а не синтаксиса.

Важно не перепутать её с загрузкой. «Ошибка компиляции» (в английской среде Compilation error) — программа не собралась, плату можно даже не подключать. «Не удалась загрузка» (Failed uploading) — код в порядке, а прошивка не доехала до платы: это порт, кабель, драйвер или модель платы, и разбор для этого случая отдельный — ошибка при загрузке скетча.

expected ';' before …

Потеряна точка с запятой. Каждая команда в C++ должна заканчиваться символом ;. Хитрость в том, что компилятор замечает пропажу только на следующей команде — поэтому смотрите не только на указанную строку, но и на строку выше неё.

'x' was not declared in this scope

«Имя x не объявлено». Компилятор встретил слово, которого не знает. Причины по частоте:

• Опечатка. C++ различает большие и маленькие буквы: digitalwrite — это не digitalWrite.
• Переменная не объявлена. Прежде чем пользоваться переменной, её нужно завести: int ledPin = 13;
• Забыт #include. Команды из библиотеки работают только после её подключения в начале скетча.
• Код переехал из .ino в свой файл .cpp. В файле .ino среда сама дописывает объявления всех функций, поэтому функцию можно вызывать выше её описания. В собственном .cpp этого не происходит: там нужен прототип, а ещё строка #include <Arduino.h> — без неё «не объявлены» окажутся даже pinMode и digitalWrite.

No such file or directory

Компилятор не нашёл файл из строки #include — то есть библиотека не установлена или имя написано с ошибкой. Trema IDE в этом случае сама предлагает установить недостающую библиотеку из каталога:

expected '}' at end of input

Не закрыта фигурная скобка. Каждой открывающей { нужна закрывающая }. Поставьте курсор на скобку — редактор подсветит её пару; так легко найти, какая осталась одинокой.

redefinition of 'void setup()'

В программе две функции setup() (или две loop()). Так бывает, когда пример вставили целиком в конец существующего скетча. В программе должна остаться ровно одна setup() и одна loop() — перенесите нужные команды внутрь существующих функций.

Скетч слишком большой: программа не помещается в память

Код написан правильно, но прошивка не влезает в плату: у Arduino Uno всего 32 КБ под программу и 2 КБ оперативной памяти. Trema IDE показывает карточку «Программа не помещается в память платы»; что именно занимает байты, что значат строки «Скетч использует … байт» и «Глобальные переменные используют … байт» и как освободить память — в отдельной статье «Память Arduino».

In file included from … / compilation terminated

Ошибка не в вашем файле, а внутри библиотеки, которую вы подключили. Цепочка In file included from — это след: кто кого подключил, пока компилятор не дошёл до места поломки. Читать её надо снизу вверх, но чинить обычно не код библиотеки.

• Чаще всего библиотека просто не подходит вашей плате: код для AVR не собирается под ESP32 и наоборот;
• бывает, что установлены две библиотеки с одинаковыми именами файлов — уберите лишнюю;
• строка compilation terminated означает, что компилятор сдался и остановился: причина — в сообщении прямо над ней, а не в ней самой.

Если цепочка ведёт не в библиотеку, а в ваш собственный файл — дело в том, как проект разложен по файлам. Разбор таких сообщений — multiple definition, undefined reference, redefinition — с причинами и лечением собран в статье «#include и свои файлы .h и .cpp».

warning: — это не ошибка

Строки со словом warning сборку не останавливают: компилятор просто предупреждает, что место подозрительное. Скетч при этом собирается и заливается. Если сборка упала, ищите строку со словом error — предупреждения к делу не относятся.

Ошибка компиляции для платы Arduino Uno

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

undefined reference to `loop' — исчезла обязательная функция

Эта ошибка приходит не от компилятора, а от компоновщика, и показывает чужой файл — поэтому пугает сильнее всего:

main.cpp:43: undefined reference to `setup'
main.cpp:46: undefined reference to `loop'
collect2.exe: error: ld returned 1 exit status

Строки 43 и 46 — это места внутри ядра Arduino, где вызываются ваши функции. Значит, в скетче нет функции void loop() (или void setup()). Обе обязательны, пусть даже с пустым телом. Вторая частая причина — опечатка в подписи: void loop(int n) для компилятора это уже другая функция, поэтому нужной он не находит. Разбор с исходником ядра — в статье про setup() и loop().

В скетче отсутствует основной файл

Английская версия — main file missing from sketch. Это вообще не ошибка кода: среда не смогла открыть скетч, потому что имя главного файла .ino не совпадает с именем папки. Правило спецификации Arduino: папка moy_proekt должна содержать файл moy_proekt.ino.

Чаще всего так бывает, когда скачали один файл .ino из интернета и открыли прямо из «Загрузок». Лечение: создать папку с тем же именем, что у файла, и положить файл внутрь. Подробно про устройство скетча — на странице «Скетчи Arduino».

Недостаточно памяти, программа может работать нестабильно

Английский вариант — Low memory available, stability problems may occur. Это предупреждение, а не ошибка: скетч собрался, залить его можно. Среда сообщает, что глобальные переменные заняли слишком много оперативной памяти. Мы измерили порог: сообщение появляется, когда занято строго больше 75 % памяти. На Arduino Uno 1536 байт из 2048 (ровно 75 %) проходят молча, а с 1537 байт предупреждение уже печатается.

Игнорировать не стоит: оставшееся место нужно для локальных переменных и стека, и при нехватке плата начинает вести себя необъяснимо — перезагружаться, терять данные, зависать. Что делать — разобрано на странице «Память Arduino»: самый быстрый приём — обернуть текстовые строки в F(), это освобождает сотни байт.

Ошибка не в коде: сборка прошла, а загрузка — нет

Если сборка закончилась успешно, а дальше пишет об ошибке порта — это не ошибка компиляции, а связь с платой: не выбран или занят COM-порт, не установлен драйвер, кабель без данных. Полное дерево причин — на странице «Произошла ошибка при загрузке скетча», а как вернуть плату в список портов — в инструкции «Плата не видна: драйверы CH340 и CP2102».

Ошибка не в коде: среда не открылась или не скачала платы

Бывает и так, что до компиляции дело не доходит. Если Arduino IDE не запускается, висит на заставке или показывает белое окно — это разбор по симптомам на странице «Arduino IDE не запускается». Если же среда открылась, но менеджер плат и библиотек пуст, а в консоли мелькает «403 Forbidden» — вам сюда: разбор ошибки 403 и загрузки списков.