Логотип Arduino IDE Arduino IDE

Руководства &
Устранение неполадок

Пошаговые решения распространённых проблем, помощь в установке и лучшие практики для максимально эффективного использования Arduino IDE.

Распространённые проблемы

Проблемы и решения

Быстрые исправления для наиболее часто сообщаемых проблем при установке или использовании Arduino IDE.

1

IDE не обнаруживает плату

  1. Убедитесь, что USB-кабель поддерживает передачу данных, а не только зарядку.
  2. Установите правильный драйвер платы для вашей операционной системы.
  3. Выберите правильную модель платы и PORT в меню Tools.
  4. Перезапустите IDE с подключённой платой.
  5. Попробуйте другой USB-порт или кабель, если обнаружение по-прежнему не работает.
2

Ошибки компиляции при загрузке

  1. Проверьте, что выбраны правильная плата и процессор.
  2. Убедитесь, что все необходимые библиотеки установлены через Library Manager.
  3. Изучите сообщение об ошибке в выходной консоли для номеров строк.
  4. Обновите ядро платы до последней версии.
  5. Используйте инструмент автоформатирования для выявления проблем синтаксиса.
3

Serial Monitor показывает искажённый текст

  1. Сопоставьте скорость передачи в Serial Monitor с настройкой вашего скетча.
  2. Выберите правильное окончание строки: No Line Ending, NL или CR+NL.
  3. Закройте другие программы, которые могут использовать тот же COM-порт.
  4. Убедитесь, что плата запитана и не находится в режиме сброса.
4

Конфликты библиотек и отсутствующие зависимости

  1. Откройте Library Manager и найдите отсутствующую библиотеку по имени.
  2. Установите точную версию, рекомендованную автором библиотеки.
  3. Удалите дублирующиеся библиотеки из папки скетчей.
  4. Перезапустите IDE после установки или обновления библиотек.
Установка

Пошаговые руководства

Подробные инструкции по установке Arduino IDE на каждую поддерживаемую платформу.

Лучшие практики

Работайте умнее

Рекомендации от сообщества и основных разработчиков для комфортной работы с Arduino IDE.

Обновляйте ядра

Регулярно обновляйте ядра плат через Board Manager. Обновления включают исправления ошибок, улучшения производительности и поддержку новых вариантов оборудования.

Используйте контроль версий

Храните скетчи в репозитории Git. Это защищает вашу работу, позволяет сотрудничать и отслеживать изменения по мере развития проектов.

Организуйте папками

Используйте структуру папок скетчей для организации связанных проектов. Создавайте подпапки для библиотек, определений оборудования и ресурсов проекта.

Тестируйте поэтапно

Пишите и тестируйте небольшие участки кода перед их объединением. Это значительно упрощает отладку по сравнению с разбором большого сложного скетча сразу.

Читайте сообщения об ошибках

Arduino IDE предоставляет подробные сообщения компиляции и загрузки. Внимательное чтение часто выявляет точную строку и суть проблемы.

Ресурсы сообщества

Форумы Arduino и сообщества Stack Exchange — отличные ресурсы. Ищите перед публикацией; у большинства распространённых проблем есть документированные решения.

Антивирус

Понимание предупреждений антивируса

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

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

  • Проверьте цифровую подпись файла установщика
  • Сравните контрольную сумму SHA-256 с опубликованным значением
  • Добавьте исключение для Arduino IDE в настройках антивируса
  • Соберите IDE из исходников, если предпочитаете полный контроль
Скачать