在Mac上配置adb，核心动作只有两步：安装Android SDK Platform-Tools，再把platform-tools目录写进shell的PATH环境变量，终端出现adb version的版本号即成功。 无论你是用Intel芯片的MacBook Pro，还是M系列芯片的MacBook Air，这套逻辑都通用,下面按实际排错顺序拆开讲。
为什么Mac需要单独配置adb？先理解adb和平台工具
adb是什么，Mac自带吗？
Android Debug Bridge，简称adb，是Android SDK里的命令行工具，Mac不会预装adb，当你执行adb devices，终端提示command not found，说明系统找不到这个可执行文件，它不像Xcode命令行工具那样随系统提供，需要你主动把platform-tools放进环境变量，据Android开发者官网公开文档，platform-tools包含adb、fastboot等，是独立于Android Studio发布的。
哪些场景必须手动配置adb
- 真机调试：用USB连接手机，查看logcat、安装APK、抓取bugreport。
- 无线调试：Android 11以上通过
adb pair配对。 - 刷机与fastboot：解锁、刷入镜像。
- 自动化脚本：CI/CD中调用
adb install、adb shell。
多数情况下，如果你只写Java/Kotlin代码并用Android Studio点运行，IDE会自动调用内置adb，但一旦你在终端敲adb,就需要手动配置PATH。
Mac配置adb环境变量：从下载到终端生效的完整路径
通过Homebrew安装（推荐）
Homebrew是macOS上常用的包管理器，打开终端,依次执行：
- 如果没装Homebrew，执行官方安装脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装android-platform-tools：
brew install android-platform-tools - 验证安装位置：
brew --prefix android-platform-tools，通常输出/opt/homebrew/opt/android-platform-tools（M芯片）或/usr/local/opt/android-platform-tools（Intel）。 - Homebrew通常会自动链接到
/opt/homebrew/bin，该路径已在PATH中，所以直接adb version即可，若没有,继续下一步手动加PATH。
手动下载Android SDK Platform-Tools
适合不想用Homebrew,或需要固定版本的情况。
- 访问Android开发者官网的platform-tools下载页,选Mac版zip。
- 解压后把
platform-tools文件夹放到一个稳定路径，
/Users/你的用户名/Library/Android/sdk/platform-tools
或/usr/local/share/android-platform-tools - 打开终端,编辑shell配置文件。
配置环境变量：zsh与bash的区别
macOS Catalina之后默认shell是zsh，配置文件是~/.zshrc；老版本可能是bash，用~/.bash_profile。
- 查看当前shell：
echo $SHELL - 编辑zsh配置：
open -e ~/.zshrc或nano ~/.zshrc - 在文件末尾加入一行：
export PATH=$PATH:$HOME/Library/Android/sdk/platform-tools
如果你放在别处,替换成实际路径。 - 保存后执行：
source ~/.zshrc - 验证：
adb version，应输出Android Debug Bridge version 1.0.xx。
验证adb是否配置成功
执行which adb，应返回具体路径；执行adb devices，应列出已连接设备，若提示command not found，说明PATH没生效，检查文件名是.zshrc而非.zshrc.txt，并确认路径拼写，业内专家指出,PATH配置错误是Mac上adb不可用的最常见原因。
MacBook M芯片如何配置adb？Apple Silicon兼容性要点
M1/M2/M3/M4芯片原生支持情况
Apple Silicon Mac从M1开始，platform-tools已经提供arm64原生版本，Homebrew安装的android-platform-tools在/opt/homebrew下，默认就是原生，手动下载时，官网提供的Mac版通常同时包含x86_64和arm64二进制，或通过通用二进制运行，行业共识认为,目前adb在M芯片Mac上已无明显兼容障碍。
Rosetta转译与原生工具选择
如果你从旧Intel Mac迁移，可能保留了x86_64的adb，执行file $(which adb)可查看架构，显示arm64为原生，x86_64则通过Rosetta运行，建议用brew reinstall android-platform-tools换成原生版，减少转译层带来的偶发卡顿，无线调试和USB连接在两种架构下都能用,但原生版启动更快。
Mac与Windows配置adb对比：差异与选择
路径分隔符与终端命令差异
| 对比项 | Mac | Windows |
|---|---|---|
| PATH分隔符 | 冒号 | 分号 |
| 配置文件 | ~/.zshrc |
系统环境变量 |
| USB驱动 | 通常免驱 | 多数需装驱动 |
| 终端 | zsh/bash | CMD/PowerShell |
Mac终端命令区分大小写，Windows不区分，Mac通常无需安装USB驱动，Windows多数机型需要装Google USB Driver或厂商驱动。
驱动安装差异
Windows上adb devices显示unauthorized或空列表，经常是驱动问题，Mac一般免驱，但部分国产手机需要手动在开发者选项里打开“USB调试（安全设置）”，对比来看，Mac配置adb的门槛主要在PATH，Windows的门槛在驱动，无论你在北京中关村还是深圳南山，步骤一致,区别只在手机品牌。
常见故障排查：mac配置adb后设备不识别怎么办
adb devices无设备
按顺序检查：
- 数据线是否支持数据传输,有些线只供电。
- 手机开发者选项是否开启,USB调试是否打开。
- 连接模式选“文件传输”或“MTP”，不要选“仅充电”。
- 终端执行
adb kill-server，再adb start-server,然后重新插拔。 - 手机上是否弹出“允许USB调试”授权框,勾选始终允许。
权限报错与USB调试
如果提示no permissions，先确认手机端授权,仍不行可尝试：
adb devices查看设备序列号。adb -s 序列号 shell指定设备。- 部分品牌需要开启“USB调试（安全设置）”或“允许模拟位置”。
端口占用与adb kill-server
adb默认监听5037端口，如果其他程序占用,执行：
lsof -i :5037查看占用进程。adb kill-server结束旧服务。adb start-server重新启动。
多数情况下,重启adb服务能解决连接不稳定。
进阶场景：无线调试与多设备管理
Mac配置adb无线调试
Android 11及以上支持无线调试,步骤：
- 手机和Mac连同一Wi-Fi。
- 开发者选项里打开“无线调试”。
- 点击“使用配对码配对设备”，记下IP、端口和配对码。
- 终端执行：
adb pair IP:端口,输入配对码。 - 再执行：
adb connect IP:端口（这里的端口是无线调试主界面显示的端口，不是配对端口）。 adb devices应显示设备。
多设备指定序列号
同时连接多台设备时，adb命令需加-s：
adb -s 序列号 install app.apkadb -s 序列号 shelladb -s 序列号 logcat
序列号可通过adb devices获取。
Mac配置adb需要收费吗？关于工具来源与授权
官方免费，注意第三方捆绑
adb是Android Open Source Project的一部分，Android SDK Platform-Tools本身免费，Google官方不收取费用，Homebrew也是免费开源，需要警惕的是，某些第三方下载站把platform-tools重新打包，捆绑安装器或广告，建议只从Android开发者官网或Homebrew官方仓库获取，价格方面，自己配置成本为零，时间成本大约十分钟，如果找人远程协助，可能涉及服务费,但工具本身没有授权费。
Q&A：mac配置adb高频疑问解答
mac配置adb后为什么命令行提示command not found？
PATH没有包含platform-tools目录，或shell配置文件写错，先执行echo $PATH看是否含该路径，再检查~/.zshrc或~/.bash_profile，保存后务必source，如果用了Fish等非默认shell,需要写入对应配置文件。
不安装Android Studio能配置adb吗？
可以，Homebrew安装android-platform-tools，或手动下载platform-tools压缩包，配置PATH后即可独立使用adb和fastboot，Android Studio只是集成开发环境,不是adb运行的必要条件。
Mac配置adb支持哪些Android版本？
adb工具向前兼容，新版本platform-tools通常能连接从较老Android到最新版本的设备，具体支持范围以Android开发者官网的platform-tools版本说明为准，截至2026年,持续更新平台工具即可覆盖主流设备。
Mac配置adb的关键就是让终端找到adb可执行文件，PATH对了，一切就顺了。 按上面的步骤操作,你可以在十分钟内完成从下载到真机调试的全过程。