adb: команда не найдена — как исправить ошибку в Windows, macOS и Linux

Что означает ошибка adb: command not found

Ошибка adb: command not found (в Windows — 'adb' не является внутренней или внешней командой...) означает, что ваша операционная система не может найти исполняемый файл утилиты Android Debug Bridge (ADB) в каталогах, указанных в системной переменной PATH.

Полный текст ошибки может выглядеть так:

• Windows (CMD/PowerShell): 'adb' is not recognized as an internal or external command, operable program or batch file.
• macOS/Linux (Bash/Zsh): bash: adb: command not found
• В IDE (Android Studio, VS Code): Ошибка запуска внешней команды.

Эта ошибка возникает в момент попытки запуска любой команды ADB (adb devices, adb install, adb shell и т.д.) из любого места в терминале, кроме самой папки, где лежит исполняемый файл adb.

Причины возникновения

1. ADB не установлен. На компьютере отсутствует пакет platform-tools, содержащий adb.exe (Windows) или просто adb (macOS/Linux).
2. Установлен, но путь не прописан в PATH. ADB установлен в какую-то папку (например, C:\Users\Name\AppData\Local\Android\Sdk\platform-tools), но эта папка не добавлена в системную переменную PATH. Поэтому терминал не знает, где искать исполняемый файл.
3. Терминал/сессия не перезапущена. Путь в PATH был добавлен, но текущее окно терминала было открыто до этого изменения. Новые сессии увидят обновлённый PATH, а старая — нет.
4. Повреждение установки. Файл adb отсутствует или повреждён в папке platform-tools.
5. Конфликт прав доступа (Windows). Попытка запустить adb из системной папки (например, C:\Program Files) без прав администратора может блокироваться.

Способы решения

Способ 1: Скачать и добавить Platform-Tools в PATH (рекомендуемый)

Это правильный и универсальный способ, делающий команду adb доступной из любого места.

1. Скачайте Platform-Tools.
   • Перейдите на страницу SDK Platform Tools на сайте Android Developers.
   • Выберите архив для вашей ОС (Windows, macOS, Linux) и скачайте его.
2. Распакуйте архив.
   • Создайте простую папку без пробелов и кириллицы, например:
     • Windows: C:\adb или C:\platform-tools
     • macOS/Linux: ~/adb или ~/platform-tools
   • Распакуйте содержимое скачанного архива (должны появиться файлы adb, adb.exe, fastboot и др.) в эту папку.
3. Добавьте путь в переменную PATH.
   • Для Windows 10/11:
     1. Нажмите Win + R, введите sysdm.cpl → вкладка «Дополнительно» → «Переменные среды».
     2. В разделе «Системные переменные» (или «Переменные среды пользователя») найдите переменную Path, выберите её и нажмите «Изменить».
     3. Нажмите «Создать» и добавьте полный путь к вашей папке (например, C:\adb).
     4. Нажмите «ОК» во всех окнах.
   • Для macOS (используется shell zsh по умолчанию):
     1. Откройте Терминал.
     2. Выполните команду open ~/.zshrc (или open ~/.bash_profile для bash).
     3. В конце файла добавьте строку:

        export PATH=$PATH:~/adb
        

     4. Сохраните файл и закройте редактор.
     5. Выполните source ~/.zshrc (или source ~/.bash_profile), чтобы применить изменения в текущей сессии.
   • Для Linux (bash/zsh):
     1. Откройте Терминал.
     2. Выполните nano ~/.bashrc (или ~/.zshrc).
     3. Добавьте в конец файла строку:

        export PATH=$PATH:$HOME/adb
        

     4. Нажмите Ctrl+X, затем Y и Enter для сохранения.
     5. Выполните source ~/.bashrc.
4. Проверьте установку.
   • Откройте НОВОЕ окно терминала или командной строки.
   • Введите команду:

     adb version
     

   • Вы должны увидеть номер версии (например, Android Debug Bridge version 1.0.41). Если да — проблема решена.

Способ 2: Запускать ADB из папки platform-tools (временное решение)

Если нужно срочно использовать ADB, но не хотите настраивать PATH.

1. Перейдите в папку, куда вы распаковали platform-tools.

   # Windows (CMD)
   cd C:\adb
   
   # macOS/Linux
   cd ~/adb
   

2. Запускайте команды, указывая adb явно:

   ./adb devices   # Для macOS/Linux
   adb.exe devices # Для Windows (в той же папке)
   

   Недостаток: Неудобно, нужно каждый раз переходить в папку или писать полный путь.

Способ 3: Установка через менеджер пакетов (для macOS/Linux)

Если вы используете Homebrew (macOS) или пакетный менеджер дистрибутива (Linux), это самый простой способ.

• macOS (Homebrew):

  brew install android-platform-tools
  

  Homebrew автоматически добавит путь в PATH.
• Ubuntu/Debian:

  sudo apt update
  sudo apt install android-tools-adb android-tools-fastboot
  

• Arch Linux:

  sudo pacman -S android-tools
  

После установки через менеджер пакетов команда adb обычно доступна сразу. Проверьте adb version.

Способ 4: Переустановка через Android Studio (если он уже есть)

Если у вас установлен Android Studio, возможно, SDK (и platform-tools) уже есть, но путь не прописан.

1. Запустите Android Studio.
2. Перейдите в File → Settings (Windows/Linux) или Android Studio → Settings (macOS).
3. В левом меню выберите Appearance & Behavior → System Settings → Android SDK.
4. На вкладке SDK Tools найдите Android SDK Platform-Tools. Если галочка снята — установите его. Если стоит — нажмите «Apply», затем «OK» для переустановки.
5. Запомните путь к SDK (показан на вкладке Android SDK в верхней части окна, обычно C:\Users\Name\AppData\Local\Android\Sdk).
6. Добавьте путь ...\Sdk\platform-tools в переменную PATH, как описано в Способе 1.

Профилактика

• Всегда используйте официальные источники. Скачивайте platform-tools только с сайта Android Developers или через официальные менеджеры пакетов (Homebrew, apt). Это гарантирует актуальную и безопасную версию.
• Правильно настраивайте PATH один раз. После корректной настройки переменной PATH вы не будете сталкиваться с этой проблемой при обновлениях ADB — просто замените файлы в папке platform-tools на новые.
• Проверяйте PATH после изменений. После добавления нового пути всегда открывайте новое окно терминала для проверки. Команда echo %PATH% (Windows) или echo $PATH (macOS/Linux) покажет текущий список каталогов.
• Используйте изолированные среды. Для разных проектов, где требуются разные версии ADB, можно использовать инструменты вроде sdkman (для Linux/macOS) или просто хранить несколько папок platform-tools и переключаться между ними, меняя PATH или создавая алиасы.
• Не размещайте platform-tools в системных папках. Папки вроде C:\Program Files могут требовать прав администратора для записи, что усложнит обновление. Лучше использовать C:\adb или домашнюю директорию пользователя.