Категории

Как решить проблему «Слишком длинный путь» в Arduino IDE на Windows

2025-10-13 12:37:06 | Статья из категории: IOT умный дом
Ошибка компиляции кода для ардуино ИДЕ проблема длинных путей и на руссом

Проблема

(текст ошибки не помню. как обычно, проблема, что не может найти файлы хотя они на месте) При компиляции проекта в Arduino IDE на Windows вы можете столкнуться с ошибкой вида:

Слишком длинный путь к источнику.
Файловая система не поддерживает такие длинные имена исходных файлов.

Это особенно актуально, если:

Причина — ограничение Windows на длину полного пути к файлу (максимум 260 символов по умолчанию). Хотя современные версии Windows поддерживают длинные пути, многие программы (включая Arduino IDE) по-прежнему сталкиваются с этой проблемой.
У меня рабочий стол назывался вплаволрдываолпрдывавапол. вот и пришлось решать делать нового пользователя или символьную ссылку

Решения

1. Перенесите проект в корень диска

Самый простой способ — переместить папку с проектом поближе к корню диска:

C:\Arduino\MyProject\

Такой путь почти гарантированно уложится в лимит и избавит вас от ошибок компиляции.

2. Включите поддержку длинных путей в Windows (только Windows 10/11 и Server 2016+)

Windows позволяет отключить ограничение в 260 символов. Для этого:

  1. Откройте редактор реестра (Win + R → введите regedit).
  2. Перейдите по пути:
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
  3. Найдите параметр LongPathsEnabled. Если его нет — создайте его:
    • Тип: DWORD (32-bit)
    • Значение: 1

Или выполните в командной строке от имени администратора:

reg add "HKLM\SYSTEM\CurrentControlSet\Control\FileSystem" /v LongPathsEnabled /t REG_DWORD /d 1 /f

Важно: После изменения реестра перезагрузка не обязательна, но некоторые приложения (включая Arduino IDE) могут потребовать перезапуска.

3. Используйте subst — создайте виртуальный диск

Команда subst позволяет «привязать» длинную папку к короткой букве диска:

subst X: "C:\Users\ДлинноеИмяПользователя\Documents\Arduino\projects\very_long_project_name"

Теперь откройте проект через X:\ — путь станет короче, и Arduino IDE сможет его обработать.

4. Измените расположение папки скетчей в настройках Arduino IDE

  1. Откройте Arduino IDE.
  2. Перейдите в Файл → Настройки.
  3. В поле «Папка для скетчей» укажите короткий путь, например:
    C:\Arduino
  4. Нажмите «OK» и перезапустите IDE.

Все новые проекты будут создаваться в этом месте, а старые можно вручную переместить туда же.

5. Используйте альтернативные IDE (опционально)

Как создать символьную ссылку в Windows

Символьная ссылка (symbolic link) — это «прозрачный ярлык» на уровне файловой системы. Программы (включая Arduino IDE) видят её как обычную папку, но она указывает на другое, возможно очень длинное, расположение. Это отличный способ обойти ограничение Windows на длину пути (260 символов).

Шаги для создания

  1. Откройте командную строку от имени администратора:
    Нажмите Win + S, введите cmd, кликните правой кнопкой → Запуск от имени администратора.
  2. Выполните команду mklink:
    mklink /D "C:\КороткийПуть" "C:\Полный\Длинный\Путь\К\Вашей\Папке"
    Пример:
    mklink /D "C:\ArduinoProj" "C:\Users\ОченьДлинноеИмя\Documents\Arduino\Проекты\МойСуперДлинныйПроект"

    ⚠️ Обязательно заключайте пути в кавычки, если в них есть пробелы или специальные символы.

  3. Готово! Теперь открывайте папку C:\ArduinoProj в Arduino IDE — путь короткий, и ошибка «Слишком длинный путь» исчезнет.

Важно:

  • Символьная ссылка — это не копия. Все изменения в ней происходят в оригинальной папке.
  • Не удаляйте оригинальную папку — иначе ссылка станет «битой».
  • Чтобы удалить ссылку — просто удалите папку C:\ArduinoProj как обычную. Это не удалит исходные файлы!

Если проблема не исчезает, попробуйте:

Заключение

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

Удачи в ваших проектах! 🛠️

Комментарии

Пока нет комментариев. Будьте первым!

Оставить комментарий

← Назад к списку статей

Важно: Блог-эксперимент

Блог только запустил, все статьи генерирую через нейросеть т.к. лень, возможны ошибки. Просто чтобы вы знали и не запускали ядерный реактор по моим статьям ))
Если у вас есть вопросы, или Нашли неточность? пишите в коментах — вместе поправим и сделаем статью более качественной. Я лично объясню нюансы из практики.

Посетителей сегодня: 0


Кто я | Контакты и регион

© Digital Specialist | Не являемся сотрудниками Google, Яндекса и NASA