ADB未找到需安装并配置环境变量,推荐用Homebrew一键安装;也可通过Android Studio SDK或手动下载platform-tools配置PATH;最后验证adb version和adb devices是否正常。

如果您希望在 macOS 系统中使用 Android Debug Bridge(ADB)与 Android 设备通信,但终端中输入 adb 命令提示“command not found”,则说明 ADB 尚未正确安装或环境变量未配置。以下是多种可行的安装与配置方法:
一、使用 Homebrew 安装(推荐)
Homebrew 是 macOS 上主流的包管理器,可一键安装并自动配置环境变量,适合大多数开发者快速启用 ADB。
1、检查是否已安装 Homebrew:在终端中执行 which brew,若返回路径则已安装;否则需先安装。
2、若未安装,运行官方安装命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
3、安装 Android Platform Tools:brew install android-platform-tools。
4、验证安装结果:adb version,应显示版本号及安装路径。
二、通过 Android Studio 自带 SDK 安装
此方式适用于已安装 Android Studio 的用户,ADB 作为 SDK Platform-tools 组件被集成,无需额外下载独立工具包。
1、启动 Android Studio,进入 Preferences → Appearance & Behavior → System Settings → Android SDK。
2、点击右侧 SDK Tools 标签页,勾选 Android SDK Platform-Tools。
3、点击 Apply 并完成安装。
4、确定 SDK 安装路径,通常为 ~/Library/Android/sdk;记下该路径中的 platform-tools 子目录完整路径。
5、编辑 shell 配置文件(zsh 用户为 ~/.zshrc,bash 用户为 ~/.bash_profile),添加以下两行(替换 YOUR_USERNAME 为实际用户名):
export ANDROID_HOME=/Users/YOUR_USERNAME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools。
6、使配置生效:source ~/.zshrc 或 source ~/.bash_profile。
三、手动下载 platform-tools 压缩包配置
此方式不依赖 Android Studio 或 Homebrew,适合轻量级使用或离线环境,需手动解压并显式声明路径。
1、访问官方下载页面:https://developer.android.com/studio/releases/platform-tools,下载 macOS 版本的 platform-tools-latest-darwin.zip。
2、解压压缩包,将 platform-tools 文件夹移至稳定路径,例如:~/Downloads/platform-tools。
3、确认该目录绝对路径,例如:/Users/YOUR_USERNAME/Downloads/platform-tools。
4、编辑 shell 配置文件(同上),在末尾追加:export PATH=$PATH:/Users/YOUR_USERNAME/Downloads/platform-tools。
5、保存后执行:source ~/.zshrc(或对应配置文件)。
四、验证 ADB 是否可用
配置完成后,需确认 adb 命令可全局调用且能识别设备,这是环境就绪的关键标志。
1、在任意终端窗口中输入:adb version,确认输出包含有效版本信息。
2、连接 Android 设备并开启 USB 调试模式。
3、执行:adb devices,若列出设备序列号及 device 状态,则表示 ADB 客户端、服务器与设备守护进程 adbd 通信正常。
五、USB 调试权限与设备识别异常处理
当 adb devices 显示 ??????????? no permissions 或空白列表时,通常因 macOS 权限或设备驱动问题导致。
1、确保 Android 设备已开启开发者选项和 USB 调试:连续点击“关于手机”中“版本号”七次启用开发者选项,再进入“开发者选项”启用“USB 调试”。
2、拔插 USB 线缆后,在设备屏幕上确认是否弹出“允许 USB 调试”授权提示,勾选“始终允许”并点确定。
3、在终端中重启 ADB 服务:adb kill-server && adb start-server。
4、如仍不识别,尝试更换 USB 线缆或接口,并避免使用 USB 集线器。










