Ошибка adb is not recognized as an internal or external command (или её русский вариант «adb не является внутренней или внешней командой») появляется в терминале тогда, когда система не может найти исполняемый файл adb.exe ни в текущей папке, ни в путях, прописанных в переменной окружения PATH. Это не сбой самого Android Debug Bridge, а проблема его установки или настройки окружения.
Хорошая новость: ошибка устраняется без переустановки системы и без риска для устройства. Ниже разберём, как проверить, установлен ли ADB вообще, куда он мог быть распакован и как правильно прописать путь к нему на Windows, macOS и Linux.
Почему система не находит команду adb
Командная строка ищет исполняемые файлы только в двух местах: в текущем каталоге и в списке папок, перечисленных в переменной PATH. Если Android SDK Platform-Tools распакован в произвольную папку, а путь к ней в PATH не добавлен, терминал честно сообщает, что команда не найдена.
Типичные сценарии, которые приводят к этой ошибке:
- 🔧 ADB не установлен — архив Platform-Tools не скачан или удалён антивирусом.
- 📁 Неверная рабочая папка — команда вводится не из каталога, где лежит adb.exe, и PATH не настроен.
- ✂️ Опечатка в PATH — путь добавлен с ошибкой, лишним пробелом или указывает на родительскую папку вместо каталога с adb.exe.
- 🔄 Не перезапущен терминал — изменения переменных окружения применяются только к новым окнам командной строки.
Отдельный случай — запуск через PowerShell из папки с adb. Там для исполняемых файлов из текущего каталога требуется префикс: .\adb devices. Без точки и слэша PowerShell выдаст похожую ошибку, хотя файл на месте.
Шаг 1. Проверяем, где находится adb
Прежде чем править переменные окружения, убедитесь, что сам файл существует. Если Platform-Tools ещё не загружены, скачайте официальный архив SDK Platform-Tools с сайта для разработчиков Android и распакуйте его в папку без кириллицы и пробелов в пути, например C:\platform-tools.
Проверка простая: откройте папку с распакованным архивом и убедитесь, что внутри есть файл adb.exe (на macOS и Linux — просто adb). Затем откройте терминал прямо в этой папке и выполните:
adb versionЕсли выводится номер версии — инструмент рабочий, и проблема только в PATH. Если и здесь команда не находится, проверьте, что вы действительно находитесь в нужном каталоге (команда cd покажет текущий путь), а в PowerShell добавьте префикс .\.
Шаг 2. Добавляем adb в PATH на Windows
Чтобы команда работала из любого каталога, путь к папке с adb нужно прописать в системную переменную Path. Действия обратимы и безопасны: достаточно аккуратно добавить одну строку.
Порядок действий для Windows 10 и Windows 11:
- 🪟 Нажмите
Win + R, введитеsysdm.cplи откройте вкладку «Дополнительно». - ⚙️ Нажмите «Переменные среды» и в списке пользовательских или системных переменных найдите
Path. - ➕ Нажмите «Изменить» → «Создать» и вставьте полный путь к папке, например
C:\platform-tools. - ✅ Подтвердите все окна кнопкой «ОК» и закройте все открытые окна терминала.
После этого откройте новую командную строку и выполните adb version. Если версия выводится — настройка завершена. Учтите: уже открытые окна cmd и PowerShell не подхватят новое значение PATH, их нужно закрыть и открыть заново.
☑️ Проверка настройки adb на Windows
Шаг 3. Настройка на macOS и Linux
На macOS и Linux логика та же: либо запускать adb из папки Platform-Tools с префиксом ./adb, либо добавить путь в PATH через конфигурационный файл оболочки. Для bash это обычно ~/.bashrc, для zsh (стандарт в современных macOS) — ~/.zshrc.
Откройте соответствующий файл в текстовом редакторе и добавьте строку, подставив реальный путь к папке:
export PATH="$PATH:/Users/имя/platform-tools"Затем примените изменения командой source ~/.zshrc (или source ~/.bashrc) либо просто откройте новое окно терминала. На Linux также убедитесь, что у файла adb есть права на исполнение — при необходимости выполните chmod +x adb в папке Platform-Tools.
⚠️ Внимание: не скачивайте adb.exe со сторонних сайтов и «сборок». Исполняемые файлы из неофициальных источников могут быть модифицированы. Загружайте Platform-Tools только с официального ресурса Android Developers.
Отличия ошибок: не путайте причины
Сообщение «adb не найден» легко спутать с другими сбоями, у которых совершенно иные причины. В таблице — типичные варианты и что они означают.
| Текст ошибки | Причина | Что делать |
|---|---|---|
| «adb не является внутренней или внешней командой» | adb нет в PATH или в текущей папке | Добавить путь в Path или перейти в папку platform-tools |
| «adb: command not found» | То же на macOS/Linux | Настроить PATH в .zshrc/.bashrc или использовать ./adb |
| «no devices/emulators found» | ADB работает, но не видит устройство | Проверить кабель, отладку по USB и драйверы |
| «unauthorized» в списке устройств | На смартфоне не подтверждён доступ | Разрешить отладку в диалоге на экране устройства |
| «cannot run as root in production builds» | Ограничение прошивки устройства | Использовать обычные команды без root |
Ключевой момент: если команда adb version работает, но adb devices выдаёт пустой список, проблема уже не в PATH, а в подключении устройства — это другая ветка диагностики: кабель, режим передачи данных, включённая отладка по USB в настройках разработчика и, на Windows, установленный USB-драйвер производителя смартфона.
Типичные ошибки при настройке PATH
Даже при правильной общей схеме настройка часто ломается на мелочах. Вот что стоит проверить, если после всех действий команда по-прежнему не находится.
Во-первых, путь должен вести в саму папку с adb.exe, а не в каталог уровнем выше. Если архив распакован как C:\platform-tools\platform-tools\adb.exe (архиватор создал вложенную папку), то и в Path нужен именно внутренний путь. Во-вторых, проверьте, что путь добавлен в ту переменную Path, которую вы редактировали, — есть пользовательская и системная, обе работают, но строку легко внести не туда и потом искать её не там.
В-третьих, некоторые программы (например, Android Studio) ставят собственную копию Platform-Tools в папку SDK. Если adb там есть, можно прописать в PATH путь именно к ней — обычно это подкаталог platform-tools внутри каталога SDK. Точное расположение SDK видно в настройках Android Studio.
⚠️ Внимание: не добавляйте в Path путь к самому файлу (C:\platform-tools\adb.exe) — переменная PATH принимает только каталоги. Указывайте папкуC:\platform-toolsбез имени файла.
Как узнать, где лежит adb, если он уже установлен
В Windows откройте командную строку и выполните: where adb — если путь прописан в PATH, команда покажет расположение файла. На macOS/Linux аналогичная команда: which adb. Если вывод пустой, значит, adb либо не установлен, либо его папка не добавлена в PATH.
Если ничего не помогло
Когда PATH настроен, терминал перезапущен, а ошибка остаётся, действуйте по нарастающей. Сначала выполните в терминале команду вывода PATH (echo %PATH% в cmd, echo $PATH в macOS/Linux) и проверьте глазами, есть ли там нужная папка. Это самый надёжный способ увидеть, что система реально использует.
Далее убедитесь, что антивирус не удалил и не заблокировал adb.exe — проверьте журнал защиты и карантин. Если файла нет, распакуйте архив Platform-Tools заново. Наконец, как временный обходной путь всегда работает запуск с полным путём: C:\platform-tools\adb.exe devices — такая команда выполнится независимо от настроек PATH, что поможет отделить проблему окружения от проблемы самого инструмента.
Частые вопросы
Почему adb работает в одной папке, но не работает в другой?
Потому что командная строка ищет исполняемый файл в текущем каталоге и в папках из PATH. Если adb.exe лежит в текущей папке — команда сработает, в другом каталоге — нет. Решение: добавить папку platform-tools в переменную Path.
Нужно ли перезагружать компьютер после изменения PATH?
Перезагрузка не обязательна. Достаточно закрыть все открытые окна командной строки, PowerShell и программ, из которых запускается adb (например, терминал в Android Studio), и открыть их заново. Новые процессы подхватят обновлённую переменную.
В PowerShell пишет, что adb не найден, хотя я в нужной папке. Что делать?
PowerShell по соображениям безопасности не запускает исполняемые файлы из текущего каталога без явного указания пути. Используйте формат .\adb devices — с точкой и обратным слэшем перед именем команды.
Можно ли пользоваться adb без установки Android Studio?
Да. Для работы adb достаточно отдельного пакета SDK Platform-Tools, который распространяется официально и не требует установки среды разработки. Android Studio нужна только для полноценной разработки приложений.
Антивирус удалил adb.exe — это опасный файл?
Официальный adb из пакета Platform-Tools безопасен, но некоторые антивирусы реагируют на инструменты, способные управлять устройствами, как на потенциально нежелательные. Восстановите файл из карантина и добавьте папку platform-tools в исключения, либо скачайте архив заново с официального источника.