Ошибка «не удается найти adb» (или «adb не является внутренней или внешней командой») появляется в командной строке Windows, когда система не может обнаружить исполняемый файл adb.exe из пакета Android SDK Platform Tools. Чаще всего причина банальна: либо утилита вообще не скачана на компьютер, либо командная строка открыта не в той папке, либо путь к ADB не прописан в системной переменной PATH.
Ниже разберём все типовые сценарии: от проверки наличия файла до настройки переменных окружения и диагностики проблем с драйверами устройства. Инструкции подходят для Windows 10 и 11; для macOS и Linux логика аналогична, отличаются только команды и пути.
Почему система не находит ADB: основные причины
Команда adb — это не встроенная утилита Windows, а отдельная программа из комплекта Platform Tools, который распространяет Google. Операционная система ищет исполняемые файлы только в текущем каталоге и в папках, перечисленных в переменной PATH. Если adb.exe нигде там нет — вы получаете сообщение об ошибке.
Типичные причины выглядят так:
- 📦 Platform Tools не скачаны — пользователь пытается запустить команду, не установив сам пакет.
- 📁 Терминал открыт не в той папке — adb.exe лежит в другом каталоге, а PATH не настроен.
- ⚙️ Переменная PATH не содержит пути к папке platform-tools, либо изменения не применились.
- 🗑️ Файл adb.exe повреждён или удалён — например, антивирус поместил его в карантин.
- 🔄 Конфликт нескольких копий ADB — на компьютере установлено несколько версий из разных источников.
Шаг 1. Проверьте, установлен ли ADB на компьютере
Первое действие — убедиться, что файл adb.exe вообще существует на диске. Откройте проводник и поищите папку platform-tools. Если вы её не скачивали, загрузите архив SDK Platform Tools с официального сайта Android Developers — это единственный гарантированно безопасный источник.
Распакуйте архив в простую папку без кириллицы и пробелов в пути, например C:\platform-tools. Внутри должны находиться файлы adb.exe, fastboot.exe и ряд библиотек .dll. Если adb.exe отсутствует в распакованном архиве — скачайте пакет заново, возможно, загрузка была прервана.
Шаг 2. Запустите ADB из папки установки
Самый быстрый способ проверить работоспособность утилиты — открыть командную строку прямо в папке с adb.exe. Для этого откройте каталог platform-tools в проводнике, кликните по адресной строке, введите cmd и нажмите Enter. Командная строка откроется уже в нужном каталоге.
Теперь выполните проверочную команду:
adb versionЕсли в ответ выводится номер версии Android Debug Bridge — утилита работает, и проблема сводится к настройке PATH. Если ошибка сохраняется даже внутри папки — файл повреждён или заблокирован, переходите к разделу про антивирус.
☑️ Базовая проверка ADB
Шаг 3. Добавьте путь к ADB в переменную PATH
Чтобы команда adb работала из любой папки, нужно прописать каталог platform-tools в системную переменную окружения PATH. Это избавит от необходимости каждый раз открывать терминал в папке с утилитой.
Порядок действий в Windows 10 и 11:
- 🔍 Откройте «Пуск» и введите
Изменение системных переменных среды, затем откройте найденный пункт. - 🖱️ Нажмите кнопку «Переменные среды» внизу окна.
- 📋 В списке системных переменных найдите
Path, выделите её и нажмите «Изменить». - ➕ Нажмите «Создать» и вставьте полный путь, например
C:\platform-tools. - ✅ Подтвердите все окна кнопкой «ОК» и перезапустите командную строку — старые окна терминала не видят новые переменные.
⚠️ Внимание: после изменения PATH обязательно закройте и заново откройте все окна командной строки, PowerShell и терминалы в редакторах кода. Работающие процессы не подхватывают обновлённые переменные окружения автоматически.
Проверьте результат: в новом окне терминала выполните adb version из любой папки. Если версия отображается — настройка завершена.
Шаг 4. Разберитесь с конфликтами и блокировками
Иногда adb.exe на месте, PATH настроен, но команда всё равно не работает или ведёт себя странно. Здесь возможны два сценария: блокировка файла защитным ПО и конфликт нескольких копий утилиты.
Некоторые антивирусы ошибочно отправляют исполняемые файлы из Platform Tools в карантин. Проверьте журнал вашего антивируса и, если adb.exe там обнаружится, восстановите файл и добавьте папку platform-tools в исключения — при условии, что архив скачан с официального сайта Google.
Второй сценарий — несколько версий ADB на одном компьютере. Их часто устанавливают эмуляторы, программы для прошивки и старые копии Platform Tools. Узнать, какая именно копия запускается, поможет команда:
where adbЕсли в выводе несколько путей — лишние лучше удалить из PATH или переименовать старые папки, оставив одну актуальную версию. Смешение разных версий adb-сервера и клиента вызывает ошибки вида «adb server version doesn't match», которые решаются перезапуском сервера командой adb kill-server с последующим adb start-server.
Как проверить PATH вручную
Откройте командную строку и выполните команду echo %PATH%. В выводе найдите путь к папке platform-tools. Если его нет — переменная настроена неправильно или изменения не применились. Проверьте, что вы редактировали именно системную переменную Path, а не пользовательскую, и что терминал перезапущен.
Шаг 5. ADB запускается, но не видит устройство
Отдельная ситуация: команда adb находится системой, но adb devices показывает пустой список или статус unauthorized. Это уже не проблема PATH, а вопрос подключения смартфона.
Что нужно проверить в этом случае:
- 🔌 Отладка по USB включена в разделе «Для разработчиков» на смартфоне (сам раздел активируется многократным нажатием на «Номер сборки» в сведениях о телефоне).
- 🔐 На экране устройства подтверждён запрос «Разрешить отладку по USB?» — без этого статус будет unauthorized.
- 🧷 Используется исправный кабель, поддерживающий передачу данных, а не только зарядку.
- 💾 В Windows установлены драйверы устройства — проверьте «Диспетчер устройств»: смартфон не должен отображаться с жёлтым значком ошибки.
⚠️ Внимание: точные названия пунктов меню («Для разработчиков», «Отладка по USB») и их расположение зависят от оболочки и версии Android конкретного смартфона. Если пункт не находится, сверьтесь с документацией производителя вашей модели.
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| «adb не является внутренней или внешней командой» | PATH не настроен или терминал не перезапущен | Добавить путь в PATH, переоткрыть cmd |
| Ошибка даже в папке platform-tools | adb.exe удалён или заблокирован антивирусом | Проверить карантин, скачать пакет заново |
| «server version doesn't match» | Конфликт нескольких версий ADB | where adb, удалить лишние копии, kill-server |
| adb devices — пустой список | Отладка по USB выключена или нет драйверов | Включить отладку, проверить драйверы |
| Статус unauthorized | Не подтверждён запрос на устройстве | Разрешить отладку на экране смартфона |
Особенности для macOS и Linux
На macOS и Linux принцип тот же: система ищет adb в каталогах из переменной PATH. Если вы распаковали Platform Tools в домашнюю папку, запускайте утилиту с указанием пути: ./adb devices из каталога platform-tools, либо добавьте путь в файл конфигурации оболочки (например, ~/.zshrc для современных версий macOS).
На Linux дополнительно может потребоваться настройка правил udev для доступа к устройству без root-прав — этот момент зависит от дистрибутива, поэтому сверяйтесь с его документацией. Альтернатива — установка пакета android-tools через штатный пакетный менеджер вашего дистрибутива, если он там доступен.
Часто задаваемые вопросы
Почему после настройки PATH ошибка всё равно появляется?
Чаще всего дело в том, что командная строка не была перезапущена — старые окна терминала не видят обновлённые переменные. Также проверьте командой echo %PATH%, действительно ли путь добавлен, и убедитесь, что в нём нет опечаток и лишних пробелов.
Можно ли скачать ADB отдельно, без Android Studio?
Да. Google распространяет пакет SDK Platform Tools отдельным архивом на официальном сайте для разработчиков. Устанавливать полную Android Studio для работы с adb не требуется.
Антивирус удалил adb.exe — это вирус?
Если архив скачан с официального сайта Google, срабатывание почти наверняка ложное. Восстановите файл из карантина и добавьте папку в исключения. Если же архив был скачан со стороннего ресурса — удалите его и загрузите пакет заново из официального источника.
Что означает статус unauthorized в adb devices?
Устройство обнаружено, но не авторизовано. Отключите и заново подключите кабель, затем на экране смартфона подтвердите запрос «Разрешить отладку по USB?». Если запрос не появляется, отзовите авторизации в настройках разработчика и подключите устройство снова.
Работает ли эта инструкция для Windows 7?
Общий принцип настройки PATH идентичен, однако актуальные версии Platform Tools и драйверов могут не поддерживать устаревшие системы. Для старых ОС проверяйте совместимость конкретной версии пакета в официальной документации.