トラブル解決公開日: 約 4 分で読めます

'adb' は内部コマンドまたは外部コマンドとして認識されていません の対処法

「'adb' は、内部コマンドまたは外部コマンド…として認識されていません」や「adb: command not found」の直し方です。Windows、macOS、Linux で platform-tools をインストールし、adb を PATH に追加する手順を解説します。

adb devices と入力すると、Windows が次のように返します。

'adb' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。

英語版の Windows では次のとおりです。

'adb' is not recognized as an internal or external command,
operable program or batch file.

PowerShell では adb : The term 'adb' is not recognized...、macOS や Linux では adb: command not found と表示されます。どれも意味は同じで、パソコンが adb というプログラムを見つけられないということです。インストールされていないか、adb のあるフォルダーが PATH に入っていないかのどちらかです。

手順 1: platform-tools を入手する

ADB は Google が無料で配布している Android SDK Platform-Tools パッケージに含まれています。

  1. Android デベロッパーの公式サイトから、お使いのシステム用の Platform-Tools をダウンロードします。
  2. 移動させない場所に展開します。たとえば Windows なら C:\platform-tools、macOS や Linux なら ~/platform-tools です。

Android Studio をインストール済みなら、すでに入っています。場所は通常、Windows では %LOCALAPPDATA%\Android\Sdk\platform-tools、macOS では ~/Library/Android/sdk/platform-tools です。

何も変更せずに試す

platform-tools フォルダーの 中で ターミナルを開き、そこから adb を実行します。

  • Windows のコマンド プロンプト: cd C:\platform-tools の後に adb devices
  • Windows PowerShell: cd C:\platform-tools の後に .\adb devices (PowerShell では .\ が必要です)
  • macOS / Linux: cd ~/platform-tools の後に ./adb devices

これで動けば adb 自体は問題なく、PATH が足りないだけです。

手順 2: Windows で platform-tools を PATH に追加する

  1. スタート を押して 環境変数 と入力し、システム環境変数の編集 (Edit the system environment variables) を開きます。
  2. 環境変数... (Environment Variables...) をクリックします。
  3. ユーザー環境変数 (User variables) で Path を選び、編集 をクリックします。
  4. 新規 をクリックし、C:\platform-tools (実際のフォルダー) を入力します。
  5. すべてのウィンドウで OK をクリックします。
  6. ターミナルを 一度閉じて開き直します。開いたままのウィンドウは古い PATH のままです。

adb version で確認します。

手順 2: macOS と Linux で platform-tools を PATH に追加する

~/.zshrc (macOS) または ~/.bashrc (多くの Linux ディストリビューション) に次の行を追加します。

export PATH="$HOME/platform-tools:$PATH"

新しいターミナルを開くか source ~/.zshrc を実行し、adb version で確認します。macOS では Homebrew (brew install --cask android-platform-tools)、Debian や Ubuntu では sudo apt install adb でもインストールできます。

adb が複数ある場合

スマホ管理ソフト、エミュレーター、古い SDK は独自の adb を同梱していることがよくあります。新しい adb を入れたのに adb version が古いバージョンを表示する場合は、別のコピーが PATH の先にあります。Windows では where adb で、すべてのコピーが優先順に表示されます。macOS と Linux では which -a adb を使います。古いフォルダーを PATH から削除するか、新しいフォルダーを一番上に移動してください。バージョンの混在は、デバイスが offline と表示される よくある原因でもあります。

ADBKit ならセットアップ不要

日常的な ADB の作業だけなら、パソコンに adb を入れる必要はありません。ADBKit は Chrome や Edge の中で USB 経由で ADB を動かします。ライブ画面、キーボード入力、logcat、shell、ファイル転送、APK のインストールが使え、インストールも PATH への追加も不要です。ソフトをインストールできない、制限の厳しい会社のノートパソコンでは、これがいちばん手軽な方法になることがよくあります。

adb が動いたら次は、USB デバッグを有効にし、ADB コマンド チートシート を手元に置いておきましょう。