故障排除发布于: 阅读约 3 分钟

'adb' 不是内部或外部命令怎么办:Windows 解决方法

解决「'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 程序。要么没有安装,要么它所在的文件夹不在 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,点击 编辑(Edit)。
  4. 点击 新建(New),输入 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 version 仍显示旧版本,说明 PATH 中有另一个副本排在前面。在 Windows 上,where adb 会按顺序列出所有副本。在 macOS 和 Linux 上用 which -a adb。从 PATH 中删除旧文件夹,或把新文件夹移到最上面。版本混用也是 设备显示 offline 的常见原因。

用 ADBKit 省去配置

如果你只需要日常的 ADB 功能,电脑上根本不用装 adb。ADBKit 通过 USB 在 Chrome 或 Edge 里运行 ADB:实时画面、键盘输入、logcat、shell、文件传输和安装 APK,无需安装任何东西,也不用配置 PATH。在不能安装软件的公司电脑上,这通常是最简单的方式。

adb 能用之后的下一步:打开 USB 调试,并把 ADB 常用命令速查表 放在手边。