База знаний · Начало работы

Куда устанавливается Arduino IDE и где лежат библиотеки

Программа, пакеты плат и скетчи с библиотеками живут в трёх разных папках. Где они у Arduino IDE 2, 1.8.19 и Trema IDE, что копировать при переезде и что можно удалить.

Среда Arduino живёт не в одной папке, а в трёх. Сама программа — в Program Files, пакеты плат и компиляторы — в скрытой папке профиля, а ваши скетчи и библиотеки — в «Документах». Поэтому удалённая и поставленная заново Arduino IDE «помнит» платы и библиотеки, а библиотека, положенная в папку программы, часто не находится. Ниже — где что лежит у Arduino IDE 2, у старой 1.8.19 и у Trema IDE, что копировать при переезде на другой компьютер и что можно удалить, чтобы освободить место.

Arduino IDE 2

Цифры в скобках — с обычного рабочего компьютера, где стоят ядра AVR и пара сторонних плат; у вас будут свои.

Что	Windows	Linux и macOS
Сама программа	`C:\Program Files\Arduino IDE` — если при установке выбрали «для всех пользователей»; `C:\Users\Имя\AppData\Local\Programs\Arduino IDE` — если «только для меня» (≈530 МБ)	Linux: куда распаковали ZIP или положили AppImage; macOS: `/Applications/Arduino IDE.app`
Пакеты плат, компиляторы, индексы	`C:\Users\Имя\AppData\Local\Arduino15` (≈420 МБ, из них `packages` — 280 МБ)	Linux: `~/.arduino15`; macOS: `~/Library/Arduino15`
Скетчи и ваши библиотеки	`C:\Users\Имя\Documents\Arduino`, библиотеки — в её подпапке `libraries` (≈70 МБ при двух десятках библиотек)	Linux: `~/Arduino`; macOS: `~/Documents/Arduino`
Настройки среды	`C:\Users\Имя\.arduinoIDE` — файлы `arduino-cli.yaml` и `settings.json`, журналы	`~/.arduinoIDE`

Папка AppData в Проводнике скрыта: проще всего вставить путь в адресную строку целиком, например %LOCALAPPDATA%\Arduino15. Папку скетчей среда сама показывает в «Файл → Параметры...» в первой же строке — там же её можно и переназначить.

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

Arduino IDE 1.8.19

У старой ветки папка программы потолще: установщик кладёт её в C:\Program Files (x86)\Arduino даже на 64-битной Windows, и внутри лежат встроенные библиотеки (libraries), ядро AVR (hardware), примеры и своя Java. Класть туда свои библиотеки не надо: при обновлении среды папка стирается, а если в «Документах» лежит библиотека с тем же именем, сборка предупредит, что нашла несколько библиотек, и возьмёт одну из них — обычно из «Документов», но не всегда.

Остальное у 1.8.19 общее с 2.x: пакеты плат — в том же AppData\Local\Arduino15 (там же и preferences.txt с настройками), скетчи и библиотеки — в Documents\Arduino. Поставив рядом обе версии, вы получите одни и те же платы и библиотеки в каждой. Исключение — portable-сборка из ZIP: если рядом с arduino.exe есть папка portable, всё — скетчи, библиотеки, пакеты — хранится внутри неё, и такую папку можно носить на флешке. Подробнее — на странице про Arduino IDE 1.8.19.

Trema IDE

У Trema IDE, русской среды, совместимой с Arduino IDE, устройство другое: на Windows программа и все её данные лежат в одной папке профиля, без Program Files и прав администратора. Компиляторы и ядра плат идут в комплекте: установщик весит около полугигабайта, а после первого запуска, когда ядра распакованы, папка вырастает примерно до двух гигабайт — зато первая сборка проходит без интернета.

Что	Windows	Linux
Программа и комплект	`C:\Users\Имя\AppData\Local\Trema IDE`: там `trema_ide.exe`, подпапка `bundled` с компилятором, ядрами и встроенными библиотеками	`/usr/bin/trema_ide`, комплект — в `/usr/lib/Trema IDE/bundled`
Распакованные ядра и установленные библиотеки	`...\Trema IDE\cache`: ядра в `ac\packages`, библиотеки из каталога в `libraries\TremaApproved`, журнал `logs\diagnostics.log`	`~/.trema/cache`
Настройки	`...\Trema IDE\settings\settings.json`	`~/.trema/settings`; состояние школьного класса — `~/.local/share/trema-ide/state`
Проекты	`C:\Users\Имя\Documents\TremaProjects` — каждый проект в своей папке, внутри обычный файл `.ino`	`~/Документы/TremaProjects` (если папки «Документы» нет — `~/TremaProjects`)

Руками в cache ходить не нужно: библиотеки ставятся и удаляются в разделе «Библиотеки», ядра — в разделе «Платы». Если на том же компьютере стоит Arduino IDE и нужная библиотека уже лежит в её Documents\Arduino\libraries, Trema IDE при первой сборке сама скопирует её к себе — ничего переносить не придётся. Про папку проектов и облако подробнее — в статье «Где физически лежат проекты».

Переезд на другой компьютер

Для Arduino IDE достаточно одной папки: скопируйте Documents\Arduino целиком — в ней и скетчи, и libraries. Пакеты плат переносить не обязательно: на новом компьютере они скачаются заново через «Менеджер плат». Если интернета там не будет, возьмите и AppData\Local\Arduino15 целиком, без подпапок staging и tmp: в ней и компиляторы с ядрами, и индексы, по которым менеджеры показывают списки. Положите её в то же место на новом компьютере до первого запуска. Ссылки на сторонние пакеты плат (ESP32, STM32) живут в настройках: в 2.x это строка additional_urls в файле .arduinoIDE\arduino-cli.yaml, в 1.8 — в preferences.txt; проще заново вписать их в «Файл → Параметры...» (в 1.8 — «Настройки»), чем переносить файлы.

В Trema IDE переезд обычно сводится к входу в аккаунт: проекты лежат в облаке и сами приезжают на новый компьютер вместе со списком своих библиотек, а сами библиотеки программа доставит из каталога — для этого нужен интернет. Если облаком не пользуетесь, скопируйте папку Documents\TremaProjects. Для класса без интернета есть пакет класса с библиотеками и платами внутри.

Что можно удалить, чтобы освободить место

Arduino15\staging — скачанные архивы пакетов и библиотек. После установки они не нужны, среда качает их заново при необходимости. Здесь часто сотни мегабайт.
Arduino15\packages — ядра и компиляторы. Руками здесь ничего не удаляйте: старую версию ядра «Менеджер плат» убирает сам при обновлении, а лишнюю плату проще удалить в нём же кнопкой. Ненужный пакет на диске — это обычно сотни мегабайт.
Arduino15\tmp — временные файлы, можно чистить целиком.
Папки проектов в «Документах» не трогайте: это и есть ваши скетчи.
В Trema IDE библиотеки удаляются в разделе «Библиотеки», а папку cache руками не трогайте: в ней лежат все установленные библиотеки, они пропадут, а ядра среда будет распаковывать заново.

Три ловушки с папками

OneDrive и «Документы». Если OneDrive перенёс папку «Документы» в облако, Arduino IDE 2 может не запуститься или не увидеть скетчи — у этого есть своя страница в разборе «Arduino IDE не запускается».
Русские буквы в пути. Старые версии 1.x ломались на кириллице в пути к скетчу — например, когда пользователь Windows называется «Андрей». В Arduino IDE 2 скетчи для AVR собираются, но компиляторы ESP32, ESP8266 и RP2040 на таком пути по-прежнему спотыкаются. Trema IDE сама уводит сборку во временную папку с латинским путём, поэтому там имя пользователя не мешает.
Две копии одной библиотеки. Одна в Program Files (x86)\Arduino\libraries, другая в Documents\Arduino\libraries — и сборка берёт не ту, которую вы обновили. Держите свои библиотеки только в «Документах».

Если ошибка про библиотеку осталась, хотя папка на месте, — дальше по статье «Библиотека не найдена», а список «файл .h → библиотека» и три способа установки собраны на странице «Как установить библиотеку».

Частые вопросы

Где лежат библиотеки Arduino на компьютере?

Ваши библиотеки — в папке скетчей: C:\Users\Имя\Documents\Arduino\libraries на Windows, ~/Arduino/libraries на Linux. Встроенные библиотеки среды лежат отдельно: у 1.8.19 — в Program Files (x86)\Arduino\libraries, у 2.x — в AppData\Local\Arduino15\libraries, а Wire и SPI — внутри пакета платы. В Trema IDE установленные библиотеки хранятся в её папке cache и управляются из раздела «Библиотеки».

Что за папка Arduino15 и можно ли её удалить?

В AppData\Local\Arduino15 среда хранит пакеты плат, компиляторы, индексы и скачанные архивы. Удалить её можно — скетчи и библиотеки не пострадают, они в «Документах», — но все платы придётся скачивать заново, а с ней пропадут настройки preferences.txt и ссылки на сторонние пакеты плат. Чтобы просто освободить место, достаточно очистить подпапки staging и tmp.

Куда устанавливается Arduino IDE 2 на Windows?

В C:\Program Files\Arduino IDE, если при установке выбрали «для всех пользователей», или в C:\Users\Имя\AppData\Local\Programs\Arduino IDE, если «только для меня». В обеих папках нет ни плат, ни библиотек — они скачиваются после установки в AppData\Local\Arduino15.

Как перенести Arduino IDE с библиотеками на другой компьютер?

Скопируйте папку Documents\Arduino целиком: в ней скетчи и подпапка libraries. Платы на новом компьютере скачаются заново через «Менеджер плат»; без интернета возьмите ещё AppData\Local\Arduino15\packages и положите в то же место до первого запуска. В Trema IDE достаточно войти в аккаунт: проекты и список библиотек приедут из облака, сами библиотеки — из каталога через интернет.

Можно ли класть библиотеки в папку Program Files?

Не стоит. У Arduino IDE 2 программа в Program Files библиотеки оттуда вообще не читает, а у 1.8.19 папка Program Files (x86)\Arduino\libraries стирается при обновлении и даёт конфликт с одноимённой библиотекой из «Документов». Своё — только в Documents\Arduino\libraries.

Где Trema IDE хранит проекты и библиотеки?

Проекты — в Documents\TremaProjects, по папке на проект с обычным файлом .ino. Программа, ядра и установленные библиотеки — в C:\Users\Имя\AppData\Local\Trema IDE (на Linux — /usr/lib/Trema IDE и ~/.trema). Библиотеки и платы ставятся и удаляются из самой программы, руками в cache ходить не нужно.