Как установить Arduino IDE 2 на Windows, Mac и Linux: руководство

Установка Arduino IDE — первый шаг любого проекта на Arduino, и если делать всё по порядку, она занимает 10–15 минут: скачиваешь программу с официального сайта Arduino (arduino.cc/en/software), устанавливаешь её в свою операционную систему, подключаешь плату USB-кабелем, выбираешь плату и порт и загружаешь первый тестовый скетч — Blink. Когда крошечный светодиод на плате начинает мигать раз в секунду, настройка закончена. Руководство написано для актуальной Arduino IDE 2 (версия 2.3.10 на октябрь 2026 года); здесь же есть таблица сравнения со старой 1.8.19.

Ниже — отдельные пошаговые инструкции по установке для Windows, macOS и Linux. Затем по очереди разберём драйверы и COM-порт, выбор платы, кнопки «Проверить» и «Загрузка», монитор порта, «Менеджер библиотек» и «Менеджер плат». Здесь же — добавление пакетов для плат ESP32 и Raspberry Pi Pico, настройки вроде языка и размера шрифта, Arduino Cloud Editor, который не нужно устанавливать, и решения самых частых ошибок при установке.

Что такое Arduino IDE и какую версию скачать?

Arduino IDE (Integrated Development Environment, интегрированная среда разработки) — бесплатная программа с открытым исходным кодом, в которой ты пишешь код, компилируешь его, видишь ошибки и загружаешь его в плату по USB. За кулисами она сама запускает компилятор C++, пакеты плат и утилиты загрузки вроде avrdude или esptool; от тебя нужно только нажать две кнопки. Сегодня активно развивается Arduino IDE 2: в ней есть автодополнение, тёмная тема, встроенный отладчик и переработанный плоттер. Старую 1.8.19 всё ещё можно скачать, но она получает только критические исправления безопасности, так что если ты только начинаешь, сразу ставь IDE 2.

Системные требования и выбор нужного файла

На странице загрузки для каждой операционной системы есть несколько файлов. Arduino IDE 2 работает только в 64-битных системах; на 32-битной Windows или очень старой macOS остаётся только 1.8.19. Процессор Mac можно посмотреть в меню Apple › Об этом Mac (About This Mac): если там написано Чип: Apple M…, выбирай Apple Silicon, если Процессор: Intel — версию для Intel.

Установка Arduino IDE на Windows

1. Скачай установщик .exe для Windows со страницы загрузки и запусти его двойным щелчком. Если появится страница с просьбой о пожертвовании, можно перейти к загрузке и без него.
2. Прими лицензионное соглашение кнопкой I Agree. Затем выбери, ставить программу для всех пользователей компьютера (Anyone who uses this computer) или только для себя (Only for me); на школьном или общем компьютере для первого варианта нужны права администратора.
3. Папку установки оставь как есть и нажми Install. Когда установка закончится, оставь отмеченным Run Arduino IDE и нажми Finish.
4. Если Windows спросит «Установить программное обеспечение для данного устройства?» для USB-драйверов Arduino и совместимых плат, нажми Установить (Install): эти драйверы нужны, чтобы распознавались такие платы, как оригинальные Uno, Mega и Leonardo. Если брандмауэр запросит доступ к сети, разреши и его.
5. Когда IDE откроется, в правом нижнем углу появятся уведомления о том, что устанавливаются пакет Arduino AVR Boards и встроенные библиотеки. Не отключайся от интернета и дождись окончания: поддержка Uno, Nano и Mega приходит именно с этим пакетом.

Когда подключаешь плату, в «Диспетчере устройств» в разделе Порты (COM и LPT) должен появиться новый COM-порт. Оригинальная Uno видна как Arduino Uno (COMx), а недорогие клоны с чипом CH340 — как USB-SERIAL CH340 (COMx). Если клон висит в разделе Другие устройства как USB2.0-Serial с жёлтым восклицательным знаком, не хватает драйвера CH340; обычно Центр обновления Windows ставит его сам, а если нет, установи пакет CH341SER от производителя чипа WCH. Чипу CP2102, который стоит на многих платах ESP32, нужен драйвер CP210x VCP от Silicon Labs. Подробно о проблемах с портом и драйвером — в статье Код не загружается в Arduino.

Установка Arduino IDE на macOS

1. Скачай .dmg под свой процессор и открой его двойным щелчком. В появившемся окне перетащи значок Arduino IDE в папку Программы (Applications).
2. Открой приложение через Launchpad или Spotlight (Cmd + Space). На вопрос, точно ли открыть приложение, загруженное из интернета, нажми Открыть.
3. IDE может запросить доступ к папке Documents/Arduino, где хранятся скетчи; разреши его, иначе скетчи не будут сохраняться.
4. Когда впервые подключаешь плату к MacBook на Apple Silicon, может появиться запрос «Разрешить подключение аксессуара?». Если не нажать Разрешить, плата так и не появится в списке портов.
5. В списке портов оригинальная Uno видна как /dev/cu.usbmodem…, а клоны с CH340 — как /dev/cu.usbserial-… или /dev/cu.wchusbserial…. В свежих версиях macOS драйверы для CH340 и CP2102 уже есть; установка старых драйверов поверх обычно только всё портит.

На Mac с Apple Silicon утилиты некоторых пакетов плат всё ещё собраны для процессоров Intel. Если при компиляции или загрузке появляется ошибка bad CPU type in executable (неподходящий тип процессора), открой «Терминал» и установи Rosetta 2 командой softwareupdate --install-rosetta; этот слой трансляции от Apple позволяет запускать утилиты для Intel на чипах серии M. Если ошибка не исчезла, обнови нужный пакет плат до последней версии в «Менеджере плат».

Установка Arduino IDE на Linux (AppImage)

1. Скачай AppImage. AppImage — это приложение в одном файле, которое не требует установки; при желании перенеси его в постоянное место в домашней папке.
2. Сделай файл исполняемым: щёлкни по нему правой кнопкой и в Свойства › Права (Properties › Permissions) отметь Разрешить выполнение файла как программы. То же самое делает команда chmod +x arduino-ide_*_Linux_64bit.AppImage в терминале.
3. Запусти IDE двойным щелчком по файлу. Если появляется dlopen(): error loading libfuse.so.2 или AppImages require FUSE to run, не хватает библиотеки FUSE 2: выполни sudo apt install libfuse2 на Ubuntu 22.04 или sudo apt install libfuse2t64 на Ubuntu 24.04 и новее.
4. Добавь своего пользователя в группу dialout, чтобы получить доступ к последовательным портам: sudo usermod -a -G dialout $USER. Перезагрузи компьютер, чтобы изменение вступило в силу, иначе загрузка будет падать с ошибкой Permission denied (доступ запрещён).
5. Если порт платы с чипом CH340 или CP2102 появляется на мгновение и исчезает, его перехватывает предустановленная служба brltty для брайлевских дисплеев. Если брайлевским дисплеем ты не пользуешься, удали её командой sudo apt remove brltty, затем отключи и снова подключи плату.
6. Если на Ubuntu 24.04 IDE вообще не открывается, а в терминале видно The SUID sandbox helper binary was found, but is not configured correctly, песочницу приложения блокирует AppArmor. Временное решение — запустить IDE из терминала с параметром --no-sandbox.

Знакомство с интерфейсом Arduino IDE 2

При первом запуске IDE встречает тебя пустым скетчем: эта заготовка из функций setup() и loop() — основа любой программы для Arduino. В мире Arduino программы называют скетчами, и каждый скетч хранится как файл .ino в папке с тем же именем. Окно делится на четыре области: сверху панель инструментов и выбор платы, слева боковая панель, в центре редактор кода, а внизу панель Вывод (Output), где бегут сообщения компилятора, и монитор порта. В строке состояния в самом низу видны номер строки с курсором, выбранная плата и порт.

Выбор платы и порта

Выбор платы сообщает IDE, под какой процессор компилировать и какой утилитой загружать; выбор порта указывает на физическую плату, подключённую к компьютеру. Пока оба выбора не верны, загрузить код не получится. Подключи плату и открой выбор платы вверху: оригинальная Uno видна по названию и выбирается одним щелчком. А вот клоны с CH340 IDE опознать не может, и порт отображается как Unknown (неизвестно). В этом случае открой Выбрать другую плату и порт (Select other board and port), введи в поиске «uno», выбери слева Arduino Uno, справа — порт и нажми OK. Если непонятно, какой порт принадлежит твоей плате, отключи её, посмотри на список и подключи снова: появившийся порт и есть нужный.

Загрузка первого скетча: Blink шаг за шагом

1. Открой Файл › Примеры › 01.Basics › Blink (File › Examples). Пример откроется в новом окне: это готовый скетч из комплекта IDE, который мигает встроенным светодиодом.
2. Выбери плату и порт в выборе платы; теперь в строке состояния внизу должны быть видны название платы и порт.
3. Сначала нажми Проверить (Ctrl+R). Если в панели «Вывод» появилось Sketch uses 924 bytes (2%) of program storage space. Maximum is 32256 bytes. (скетч занимает 924 байта, 2% памяти программ, максимум 32256 байт), компиляция прошла успешно.
4. Затем нажми Загрузка (Ctrl+U). Светодиоды TX и RX на плате ненадолго замигают, а в правом нижнем углу появится уведомление Done uploading (загрузка завершена).
5. Теперь светодиод с меткой L должен секунду гореть и секунду не гореть. Чтобы убедиться, что новый код действительно загрузился, замени обе строки delay(1000) на delay(200) и загрузи снова: если мигание ускорилось, всё работает.
6. Когда попробуешь сохранить изменённый пример, IDE попросит новое имя и место, потому что примеры лежат в папке самой программы. Собственные скетчи по умолчанию сохраняются в папку Documents/Arduino — это и есть твоя папка скетчей (Sketchbook).

Эти строки в выводе рассказывают о памяти платы. Загрузчик занимает 512 байт из 32 КБ флеш-памяти ATmega328P на Uno, поэтому для кода остаётся 32256 bytes, а Blink использует всего 2% от этого объёма. Строка Global variables use 9 bytes чуть ниже показывает, сколько из 2048 байт ОЗУ занято глобальными переменными. Когда проекты растут, взгляд на эти проценты часто отвечает на вопрос «почему плата зависает?» ещё до того, как он возникнет. А теперь напиши свой первый скетч: код ниже добавляет к Blink несколько строк, которые отправляют сообщения в монитор порта, так что заодно проверяются и загрузка, и обмен данными по USB.

1// İlk test: dahili LED yanıp söner, Seri Port Ekranı'na yazı gelir
2// First test: blinks the onboard LED and prints to the Serial Monitor
3int sayac = 0;                        // kaç kez yanıp söndü / blink counter
4
5void setup() {
6  pinMode(LED_BUILTIN, OUTPUT);       // Uno'da pin 13 (L LED'i) / pin 13 (L LED) on the Uno
7  Serial.begin(9600);                 // Seri Port Ekranı hızı / Serial Monitor baud rate
8  Serial.println("Merhaba BlueGrays! / Hello BlueGrays!");
9}
10
11void loop() {
12  digitalWrite(LED_BUILTIN, HIGH);    // LED'i yak / turn the LED on
13  delay(1000);                        // 1 saniye bekle / wait 1 second
14  digitalWrite(LED_BUILTIN, LOW);     // LED'i söndür / turn the LED off
15  delay(1000);
16  sayac++;
17  Serial.print("Yanip sonme / Blink: ");
18  Serial.println(sayac);
19}

setup() выполняется один раз при включении или сбросе платы: здесь пин 13 настраивается как выход и запускается последовательная связь на скорости 9600 бод. Затем loop() повторяется бесконечно, пока на плате есть питание. LED_BUILTIN — имя пина, к которому подключён встроенный светодиод; на Uno, Nano и Mega он равен 13, поэтому один и тот же код без изменений работает на всех этих платах. Подробное объяснение команд из этого кода — в статье Команды Arduino.

Монитор порта и плоттер

После загрузки нажми значок лупы в правом верхнем углу или Ctrl+Shift+M. Монитор порта откроется в нижней панели и будет печатать новую строку при каждом мигании платы. Скорость в меню справа вверху панели должна совпадать со значением Serial.begin() в коде, то есть 9600 бод; иначе экран заполнят непонятные символы. Чтобы отправить текст на плату, введи его в поле сообщения сверху и нажми Enter. Меню окончания строки рядом предлагает No Line Ending (нет конца строки), New Line (NL), Carriage Return (CR) и Both NL & CR (NL и CR); выбери тот вариант, которого ждёт твой код.

Плоттер показывает числа в виде графика: если отправлять подписанные строки вроде Serial.print("light:"); Serial.println(value);, каждая подпись становится отдельной линией своего цвета. Это идеально, чтобы следить за значениями потенциометра или фоторезистора вживую. Во время загрузки следи, чтобы порт не держала другая программа (второе окно IDE, PuTTY, скрипт на Python): порт может быть открыт только в одной программе одновременно. Все тонкости этих инструментов собраны в статье Монитор порта Arduino.

Менеджер библиотек и менеджер плат

Большая часть силы Arduino — в готовых библиотеках. Открой Менеджер библиотек значком с книгами на левой боковой панели (Ctrl+Shift+I), введи название библиотеки в поиске (например, «DHT sensor library») и нажми Установить (Install). Если библиотека зависит от других библиотек, IDE спросит об этом; вариант Установить все (Install All) сразу избавляет от ошибок об отсутствующих файлах. Установленные библиотеки попадают в папку libraries внутри папки скетчей, а их примеры появляются в меню Файл › Примеры. ZIP-файлы, скачанные из интернета, ставятся через Скетч › Подключить библиотеку › Добавить .ZIP библиотеку... (Sketch › Include Library › Add .ZIP Library); подробности — в статье Как добавить библиотеку в Arduino.

Менеджер плат (Ctrl+Shift+B), в свою очередь, устанавливает компиляторы и утилиты загрузки для разных семейств процессоров. Пакет для Uno, Nano и Mega приходит автоматически при первом запуске; для таких плат, как Uno R4, ESP32 или Pico, нужный пакет ставится один раз. Собственные платы Arduino видны в списке сразу, а для плат других производителей сначала нужно добавить ссылку на пакет в настройках. Пакеты плат устанавливаются не в папку скетчей, а в отдельную папку Arduino15: C:\Users\username\AppData\Local\Arduino15 на Windows, ~/Library/Arduino15 на macOS и ~/.arduino15 на Linux.

Добавление пакета для плат ESP32

1. Открой Файл › Настройки (Ctrl+,) и вставь эту ссылку в поле Дополнительные ссылки для Менеджера плат (Additional boards manager URLs): https://espressif.github.io/arduino-esp32/package_esp32_index.json. Чтобы добавить несколько ссылок, нажми значок рядом с полем и впиши каждую ссылку с новой строки.
2. Нажми OK, затем открой «Менеджер плат» и введи в поиске esp32.
3. Найди esp32 by Espressif Systems и нажми Установить. Пакет весит сотни мегабайт, поэтому на медленном соединении загрузка может занять несколько минут. Пакет Arduino ESP32 Boards, который тоже появляется в списке, предназначен только для Arduino Nano ESP32; для обычных плат ESP32 ставь пакет от Espressif.
4. Выбери плату ESP32 Dev Module и порт своей платы. Большинство ESP32 DevKit используют чип CP2102 или CH340, поэтому IDE показывает плату как Unknown; это нормально.
5. Загрузи тестовый скетч ниже и поставь в мониторе порта 115200 бод. Если в выводе бесконечно идёт Connecting...., зажми кнопку BOOT на плате и отпусти её, когда побегут проценты загрузки.

1// ESP32 kurulum testi: yonga bilgisi + LED / ESP32 setup test: chip info + LED
2const int LED_PIN = 2;   // çoğu ESP32 DevKit'te dahili LED / onboard LED on most DevKits
3
4void setup() {
5  pinMode(LED_PIN, OUTPUT);
6  Serial.begin(115200);  // ESP32 için yaygın hız / common ESP32 baud rate
7  delay(1000);           // Seri Port Ekranı açılsın diye bekle / give the monitor time to open
8  Serial.print("Model: ");
9  Serial.println(ESP.getChipModel());                  // ör. ESP32-D0WD-V3 / e.g. ESP32-D0WD-V3
10  Serial.print("Cekirdek / Cores: ");
11  Serial.println(ESP.getChipCores());
12  Serial.print("CPU (MHz): ");
13  Serial.println(ESP.getCpuFreqMHz());
14  Serial.print("Flash (MB): ");
15  Serial.println(ESP.getFlashChipSize() / (1024 * 1024));
16  Serial.print("Bos RAM / Free heap (bayt / bytes): ");
17  Serial.println(ESP.getFreeHeap());
18}
19
20void loop() {
21  digitalWrite(LED_PIN, !digitalRead(LED_PIN));        // LED'i ters çevir / toggle the LED
22  delay(500);
23}

Если монитор порта показывает модель чипа, число ядер, частоту процессора 240 MHz и объём флеш-памяти (обычно 4 МБ), ESP32 настроена; если у твоей платы есть встроенный светодиод на GPIO 2, он ещё и мигает каждые полсекунды. Пины ESP32, подключение к Wi-Fi и первый проект с управлением с телефона разобраны в статье Что такое ESP32?

Добавление пакета для плат Raspberry Pi Pico

1. В настройках добавь отдельной строкой под ссылкой для ESP32 в список Дополнительные ссылки для Менеджера плат вот эту: https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json.
2. Найди в «Менеджере плат» по запросу pico пакет Raspberry Pi Pico/RP2040/RP2350 от Earle F. Philhower и установи его. Этот пакет от сообщества поддерживает Pico, Pico W, Pico 2 и Pico 2 W и работает с большинством библиотек Arduino.
3. Выбери плату Raspberry Pi Pico или ту модель, которая у тебя на самом деле (Pico W, Pico 2).
4. Для первой загрузки зажми кнопку BOOTSEL на Pico, подключи USB-кабель и отпусти кнопку. Pico появится на компьютере как диск RPI-RP2 (RP2350 у Pico 2), а в списке портов — UF2 Board; выбери этот порт и нажми «Загрузка».
5. Когда код запустится, Pico откроет обычный последовательный порт. Выбери этот новый порт в списке; для следующих загрузок BOOTSEL уже не нужна, потому что IDE сама перезагружает плату.

1// Pico kurulum testi: dahili LED + yonga sıcaklığı
2// Pico setup test: onboard LED + chip temperature
3void setup() {
4  pinMode(LED_BUILTIN, OUTPUT);   // Pico'da GP25; Pico W'de kablosuz yonga üzerinden / GP25 on Pico, via the wireless chip on Pico W
5  Serial.begin(115200);           // USB seri port / USB serial port
6}
7
8void loop() {
9  digitalWrite(LED_BUILTIN, HIGH);
10  delay(500);
11  digitalWrite(LED_BUILTIN, LOW);
12  delay(500);
13  Serial.print("Yonga sicakligi / Chip temperature (C): ");
14  Serial.println(analogReadTemp());   // dahili sensör, yaklaşık değer / internal sensor, approximate
15}

Если хочешь программировать Pico на MicroPython, вместо Arduino IDE используется Thonny; разница между двумя подходами и установка MicroPython описаны в статье Что такое Raspberry Pi Pico? Учти, что загрузка из Arduino IDE стирает MicroPython с платы. Чтобы вернуть его, достаточно снова записать UF2-файл MicroPython через BOOTSEL.

Настройки: язык, размер шрифта и другие параметры

Окно настроек открывается через Файл › Настройки (на macOS — в меню приложения Arduino IDE) или по Ctrl+,. Чтобы переключить интерфейс на другой язык, выбери его в списке Язык (Language) и нажми OK; после короткой перезагрузки IDE откроется с переведёнными меню. Сообщения компилятора об ошибках остаются на английском. Вот самые полезные для новичков настройки:

Arduino Cloud Editor: код в браузере без установки

Если на компьютер нельзя ставить программы (школьный компьютер, Chromebook или ноутбук без прав администратора), хорошая альтернатива — Arduino Cloud Editor. Входишь на app.arduino.cc с бесплатным аккаунтом Arduino и создаёшь новый скетч в разделе Sketches; код хранится в облаке и одинаково открывается на любом компьютере. На Windows, macOS и Linux для загрузки в плату по USB нужно один раз установить небольшую фоновую программу Arduino Cloud Agent. На Chromebook вместо агента используется браузер или приложение Arduino Cloud for Chromebook, но там поддерживаются только Uno R3, Uno R4 и ещё несколько официальных плат Arduino. Можно пользоваться и обоими инструментами сразу: если войти в аккаунт Arduino в IDE 2, Cloud Sketchbook (облачная папка скетчей) позволит IDE дома и Cloud Editor в школе видеть одни и те же скетчи.

Частые проблемы при установке и как их решить

Установка завершена: что дальше?

• Закрепи основы: как связаны плата, пины и программирование, узнаешь из статьи Что такое Arduino?, а самые используемые команды — из руководства Команды Arduino.
• Собери первую схему: вместо встроенного светодиода сделай Blink со светодиодом и резистором на макетной плате; подходящий резистор подберёт калькулятор резистора для светодиода, а где какой пин, покажет утилита распиновки.
• Попробуй без платы: если платы ещё нет, моделируй в браузере в Tinkercad или Wokwi.
• Научись исправлять ошибки: если появились красные сообщения, загляни в руководства по ошибкам загрузки и ошибкам компиляции.
• Переходи на беспроводную связь: если пакет ESP32 уже стоит, собери первый проект с Wi-Fi по статье Что такое ESP32?
• Выбери подходящую плату: если плата ещё не куплена, загляни в статьи Какую Arduino купить? и Стартовый набор Arduino.

Правильно настроенная Arduino IDE годами работает без проблем: с новой платой достаточно установить её пакет в «Менеджере плат» и выбрать правильные плату и порт. Если Blink работает, можно двигаться дальше: в приложении BlueGrays десятки проектов для Arduino, ESP32 и Raspberry Pi Pico — от мигающих светодиодов и светофора до датчиков расстояния и проектов с Wi-Fi, у каждого есть схема подключения, список деталей и пошагово объяснённый код, который можно сразу попробовать в только что установленной IDE.