Arduino IDE не запускается: разбор по симптомам

Сначала определите, какое у вас «не запускается»

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

Ещё одна развилка — версия. У классической 1.8.19 внутри Java, и её беды одни; у 2.3.x внутри браузерный движок и отдельная фоновая программа, и беды совсем другие. Какая у вас — видно по значку и по названию папки установки: Program Files (x86)\Arduino у классической и Program Files\Arduino IDE у современной.

Шаг первый: увидеть настоящую ошибку

Самый полезный приём, который экономит час гаданий: запустите среду из командной строки и посмотрите, что она напишет. Откройте папку с программой — C:\Program Files\Arduino IDE при обычной установке или C:\Users\Имя\AppData\Local\Programs\Arduino IDE, если ставили «только для меня», — нажмите Shift и правую кнопку мыши на пустом месте и выберите «Открыть окно PowerShell здесь» (в Windows 11 этот пункт прячется за «Показать дополнительные параметры»). Введите:

& ".\Arduino IDE"

Программа запустится, а в окно PowerShell посыплются служебные строки — среди них будет та самая ошибка. Этот способ советует сотрудник Arduino на официальном форуме.

Второй источник правды — журналы. Вот где они лежат на Windows:

Обратите внимание на первую строку: папка называется «Arduino IDE» с пробелом, а рядом лежит совсем другая папка arduino-ide через дефис — это профиль окна. Их часто путают, а советы в интернете отправляют не туда.

Ваша система вообще потянет эту версию: Windows 10, 11, 7 и 32 бита

Проверьте это до всякого лечения — иначе будете чинить исправное. Arduino IDE 2.3.x официально требует Windows 10 или новее, только 64-битную.

• 32-битная Windows. Сборки 2.x для неё не существует и не будет: запрос на 32-битную версию в трекере Arduino закрыт с пометкой «не планируется». Сообщение выдаёт сама Windows, а не среда: на десятке это «Это приложение не может работать на вашем ПК», а знакомое «не является приложением Win32» — текст Windows 7 и XP. Выход — 1.8.19.
• Windows 7. Установка проходит, а запуск — нет: Windows показывает окно The procedure entry point GetPackageFamilyName could not be located in the dynamic link library KERNEL32.dll — этой функции в семёрке просто нет. Позиция Arduino: Windows 7 снята с поддержки Microsoft, среда её не поддерживает; последняя версия, которая на ней запускалась «по случайности», — 2.1.1. Правильный путь — 1.8.19.
• Windows 8.1. Тут ошибка другая: программа завершается тихо, без окна, а в журнале событий остаётся отказ приложения. Лечения нет, вариант тот же — классическая 1.8.19.
• Windows 10/11 64-бит. Требования соблюдены, идём дальше по симптомам.

Висит на заставке, зависает на логотипе, бесконечная загрузка

Самая частая история с 2.x. При первом запуске среда обязана скачать списки плат и библиотек, а вместе с ними — собственные служебные программы. Пока это не закончилось, окно не открывается. В журнале видны строки вроде:

• dial tcp: lookup downloads.arduino.cc: no such host — адрес вообще не разрешается;
• open C:\Users\…\Arduino15\library_index.json: The system cannot find the file specified — файла нет, потому что он не скачался;
• Detected an error response during the gRPC core client initialization: code: 13, message: downloading builtin:ctags@5.8-arduino11 tool: Server responded with: 403 Forbidden — а это уже отказ сервера.

Если в вашей строке стоит 403 — вам на соседнюю страницу: там разобрано, кто отдаёт отказ и что с этим делать, включая способ положить нужные файлы руками. Если ошибка про «no such host» или про время ожидания — среда не видит интернета: проверьте подключение, школьный фильтр и антивирус. Быстрая проверка «моё или не моё» — открыть в браузере https://downloads.arduino.cc/packages/package_index.json.

Ошибка 403 и списки плат: подробный разбор

Полезная особенность: классическая 1.8.19 не ждёт сеть, чтобы открыть окно — списки она обновляет в фоне, уже после запуска, поэтому открывается даже там, где 2.x стоит на заставке. Это хороший диагностический ход: если 1.8.19 запускается, а 2.3.x нет — дело не в компьютере.

Обновился до 2.3.10 — и перестала запускаться

Ветка «вчера работала, сегодня нет». Обновление 2.x ставится поверх прежней версии и подхватывает старые настройки — а они не всегда переживают переезд.

1. Сначала самое дешёвое: переименуйте AppData\Roaming\arduino-ide и .arduinoIDE (таблица сброса ниже) и попробуйте снова. Настройки от несовместимой сборки — главная причина «после обновления не открывается».
2. Проверьте систему: если у вас Windows 7 или 8.1, обновление могло перевести вас через порог совместимости. Последняя версия, которая на них запускалась, — 2.1.1.
3. Откатиться можно всегда: все прежние выпуски лежат в разделе Releases репозитория arduino-ide на GitHub. Сначала удалите текущую версию, потом ставьте старую — иначе получите две записи в списке программ. Какие версии были и чем отличались, собрано на странице про Arduino IDE 2.
4. Если вместо запуска вы видите «Ошибка при проверке обновлений» — это не про запуск, а про сеть: среда ходит за обновлениями на тот же сервер, что и за списками плат. Почему он отвечает отказом.

Запускается, но очень долго

Полминуты до окна — это не поломка, а обычно антивирус: при каждом старте он проверяет сотни файлов среды. Добавьте в исключения папку программы и Arduino15 — старт ускорится в разы. У классической 1.8.19 к этому добавляется прогрев Java, у 2.x — первый запуск после установки, когда среда докачивает служебные программы. Если «долго» превращается в «никогда», смотрите раздел про заставку выше.

Установщик не идёт: «не устанавливается»

• Файл скачался не целиком. У установщика 2.3.10 должно быть ≈158 МБ. Оборвалось на середине — качайте заново; если качается с трудом, файлы есть и на GitHub.
• Вы скачали ZIP. Он не устанавливается по определению — его распаковывают и запускают Arduino IDE.exe из папки.
• 32-битная Windows. Установщик останавливается сразу: 64-bit Windows is required.
• Нет прав администратора. Выбирайте установку «только для меня» — она ставит среду в AppData\Local\Programs\Arduino IDE и прав не требует.

Окно появляется и сразу исчезает: OneDrive и папка «Документы»

У Arduino есть отдельная статья ровно про этот симптом: «окно инициализации появляется и исчезает без всякого сообщения». Виновник — OneDrive с включённой выгрузкой файлов в облако. Папка скетчей по умолчанию лежит в «Документах», OneDrive забирает их себе, файлы физически отсутствуют на диске, и среда спотыкается. Сообщение The cloud file provider is not running при этом выдаёт сама Windows — статья Arduino так и называется, «среда не открывается».

1. Найдите в проводнике папку OneDrive\Документы\Arduino, щёлкните правой кнопкой и выберите «Всегда сохранять на этом устройстве».
2. Либо перенесите папку скетчей за пределы OneDrive — например в C:\Users\Имя\Arduino. Сделать это можно даже когда среда не открывается: путь лежит в файле .arduinoIDE\arduino-cli.yaml, ключ directories.user.
3. Саму программу тоже держите вне OneDrive.

Родственный случай: OneDrive удалили, а Windows осталась с перенаправленной папкой «Документы». Тогда в журнале будет Unable to get Documents Folder: Access is denied. Лечение — правая кнопка на «Документах» → Свойства → вкладка «Расположение» → «По умолчанию» (в английской Windows — Restore Default), путь должен стать C:\Users\Имя\Documents.

Папка скетчей на недоступном диске

Похожая ловушка без всякого облака: если в настройках указан сетевой диск или флешка, а их нет на месте, старт зависает на анимации. В журнале — Error: ENOENT: no such file or directory, mkdir '\\?'. Лечится там же, где предыдущий случай: открыть C:\Users\Имя\.arduinoIDE\arduino-cli.yaml в блокноте и поставить в directories.user существующий локальный путь.

Фоновый помощник не поднялся

Arduino IDE 2 — это на самом деле две программы: окно и фоновый помощник, который делает всю работу с платами. Они разговаривают через локальное соединение, причём номер порта среда каждый раз просит у системы — свободный, какой найдётся. Поэтому советы «поменяйте порт 50051 в настройках» бесполезны: этого номера нет ни в файлах настроек, ни в самой программе.

Если помощник не поднялся, в журнале появляется Detected an error response during the gRPC core client initialization (в сборках постарше — root ERROR Could create client for gRPC). Читайте, что стоит дальше в той же строке: чаще всего там downloading builtin:ctags@… 403 Forbidden или discovery builtin:serial-discovery not installed — то есть помощник не смог забрать свои служебные программы, и это та самая сетевая история, а не поломка запуска.

Редкий случай с ошибкой Error: 14 UNAVAILABLE: No connection established… ETIMEDOUT 127.0.0.1 на Windows 11 разбирали на форуме отдельно: там мешали виртуальные сетевые адаптеры программ туннелирования, и помогло не отключение самих программ, а запуск среды в режиме совместимости с Windows 8 (Свойства ярлыка → «Совместимость»).

Белое или пустое окно

Рамка есть, внутри пусто. Причина — отрисовка: 2.x рисует интерфейс так же, как браузер, и при рассинхроне видеодрайвера с кэшем отрисовки содержимое не появляется. Часто случается после обновления системы или драйвера.

1. Создайте ярлык с ключом: "C:\Program Files\Arduino IDE\Arduino IDE.exe" --disable-gpu и запустите его.
2. Если помогло — удалите папки GPUCache и Code Cache из AppData\Roaming\arduino-ide и попробуйте запуск без ключа.
3. На Linux тот же ключ дописывается к команде запуска: ./arduino-ide_2.3.10_Linux_64bit.AppImage --disable-gpu (у распакованного ZIP файл называется просто arduino-ide).

Редкий случай: папка временных файлов на диске в памяти

Если вы переносили TEMP на RAM-диск ради скорости, среда не стартует и пишет две строки подряд: Failed to start the electron application. и Error: EISDIR: illegal operation on a directory, realpath 'Z:\Temp' (буква — ваша). Ошибка известна с 2022 года и до сих пор не исправлена. Обход один: вернуть TEMP на обычный диск. Классическая 1.8.19 при этом работает.

Сброс настроек: что удалять и что при этом теряется

Главное, что стоит знать заранее: скетчи и установленные библиотеки лежат в папке Документы\Arduino и ни при одном из шагов ниже не удаляются. Поэтому сброс не страшен. Идите по порядку, проверяя запуск после каждого шага, и переименовывайте, а не удаляйте (например Arduino15 → Arduino15.bak) — так можно вернуть всё назад.

Ловушка для тех, кто много лет назад ставил среду из Microsoft Store: у той установки (а это была ещё 1.x) папка данных называлась не Arduino15, а ArduinoData, и лежала в «Документах». Советы «удали Arduino15» на ней просто не находят цель. У современной 2.x такого варианта нет.

Антивирус, SmartScreen и чужие процессы

Здесь много мифов, поэтому разделим подтверждённое и остальное.

• Подтверждено Arduino: конфликт с процессом Logitech LVPrcSrv.exe. Если среда зависает — откройте диспетчер задач и завершите его.
• Правдоподобно: антивирус, который проверяет сотни файлов среды при каждом старте или отправляет что-то в карантин. Добавьте в исключения папку установки и Arduino15. Если скачивали ZIP — снимите блокировку в свойствах архива до распаковки.
• Кириллица в имени пользователя. На запуск 2.x она, по нашей проверке, не влияет — подтверждённых случаев нет. А вот сборка из-за неё падает по-настоящему: признак — строки вида cannot open linker script file. Помогает учётная запись с латинским именем.
• Уточнение про SmartScreen. Обычно он предупреждает при установке малоизвестной программы. Но если вы скачали ZIP и распаковали его проводником, метка «файл из интернета» переходит на сам .exe, и тогда при запуске выскакивает «Система Windows защитила ваш компьютер». Лечится не отключением защиты, а снятием метки: правая кнопка на скачанном архиве → Свойства → галочка «Разблокировать» — и распаковать заново.

Классическая 1.8.19 не запускается

У версии на Java свои сюжеты, и они совсем не такие, как у 2.x.

• Окно с текстом про встроенную Java (только Windows): This application was configured to use a bundled Java Runtime Environment but the runtime is missing or corrupted. Java ставить не надо — она лежит внутри дистрибутива, в подпапке java, и системную среда не использует. Значит, эта папка повреждена или распаковалась не целиком. Надёжное лечение — скачать ZIP и распаковать заново в короткий путь вроде C:\arduino.
• Заставка доходит до «Preparing boards…» и программа закрывается. Так проявлялись русские буквы в имени пользователя: среда не могла создать preferences.txt и получала отказ в доступе. Находке много лет (её описали ещё на ветке 1.6), в 1.8.19 она встречается реже, но если симптом совпал — помогает переносной режим или учётная запись с латинским именем; в старых отчётах срабатывал и запуск от имени администратора.
• Переносной режим (он же portable) — главный ответ на проблемы с правами: скачайте ZIP, распакуйте, создайте внутри папку с именем portable и запускайте arduino.exe оттуда. Скетчи, библиотеки и платы будут жить в этой папке. Именно так Arduino советует ставить среду в школах, где у учеников нет прав администратора.
• Ставьте её туда, куда вам разрешено писать. В Program Files (x86) обычный пользователь файлы менять не может, а переносному режиму это нужно постоянно — среда перестанет сохранять настройки и может не запуститься. Флешка, домашняя папка или C:\arduino — правильные места. И учтите: кириллицу в имени пользователя переносной режим лечит не полностью — временные файлы всё равно берутся из профиля.

macOS и Linux

• Linux: AppImage вообще не запускается — обычно не хватает библиотеки FUSE: на Ubuntu 22.04 ставится libfuse2, на 24.04 — libfuse2t64.
• Linux: ругань про песочницу (The SUID sandbox helper binary was found, but is not configured correctly) — это другая беда, свежие Ubuntu запрещают её механизм. Обход — ключ --no-sandbox.
• macOS, «программа повреждена» — обычно следствие карантина после скачивания; снимается командой xattr -rd com.apple.quarantine с путём к приложению.
• macOS на процессорах Apple: классическая 1.8.19 собрана только под Intel и работает через Rosetta 2 — без неё не запустится. У 2.x есть родная сборка.

Похожие беды, у которых другая причина

• Среда открылась, но плата не видна — это кабель, драйвер моста CH340/CP2102 или занятый порт: разбор по шагам.
• Среда открылась, но менеджер плат и библиотек пуст — ошибка 403 и списки.
• Скетч не компилируется — это уже ошибки в коде: частые сообщения по-русски.
• Не получается даже скачать среду — что делать, если сайт не открывается. А если интернета нет вовсе, посмотрите как работать офлайн.

Порядок диагностики: пять шагов

1. Проверьте систему: 32 бита или Windows 7/8 — дальше не копайте, вам нужна 1.8.19.
2. Запустите среду из PowerShell и прочитайте вывод — это отсекает большую часть гаданий.
3. Откройте свежий журнал AppData\Roaming\Arduino IDE\сегодняшняя-дата_log.log — папка именно с пробелом в названии.
4. Найдите текст ошибки в разделах выше: 403 и «no such host» — сеть; «gRPC» — фоновый помощник не поднялся (смотрите, что стоит дальше в строке); «Documents Folder» — OneDrive; «mkdir» — недоступный диск; «realpath» — RAM-диск.
5. Если журнала нет вовсе — переименовывайте папки по таблице сброса, по одной, проверяя запуск после каждой.

Если проще сменить среду

Большая часть перечисленного — не ошибки пользователя, а свойства конструкции: среда состоит из окна, фонового помощника и десятка файлов, которые надо скачать. Мы делали Trema IDE с оглядкой ровно на эти грабли.

• Стартовый экран не ждёт сеть молча. У начальной загрузки стоит предохранитель на двенадцать секунд, а любая неудавшаяся проверка гасит экран, а не запуск: окно откроется, даже если данные не пришли.
• Платы уже внутри. Uno, Nano, Mega и вся классика AVR собираются сразу после установки, без единого обращения в интернет: компилятор лежит в самом установщике.
• Есть журнал и кнопка для поддержки. Сборка, прошивка и работа с программатором пишутся в %LOCALAPPDATA%\Trema IDE\cache\logs\diagnostics.log, а в настройках есть раздел «Если что-то сломалось» с кнопкой «Сохранить архив на диск»: в архиве журналы и сведения о системе — приложите его к письму, и разбираться будем мы, а не вы.
• Мы отвечаем по-русски и в разумный срок — это не форум с ответом через неделю.

Честно о границах: Trema IDE — тоже программа для 64-битной Windows 10/11 (есть и сборки для Linux — .deb и AppImage), на Windows 7 и 32-битных системах она не встанет, а версии для macOS у нас пока нет. Если у вас старая машина — вам всё-таки 1.8.19. Если современная — можно держать обе среды рядом: они не мешают друг другу и открывают одни и те же скетчи.