在macOS上配置ADB，最快最稳的方式是安装Homebrew后执行一次安装命令，再往shell配置文件里写上一行环境变量，整个过程约5分钟。
为什么macOS需要单独配置ADB
ADB（Android Debug Bridge）是Android开发者和刷机玩家绕不开的命令行工具，Windows用户通常去下载一个压缩包解压就能用，但macOS这边的情况略有不同系统自带的终端不会主动认识ADB命令，你需要手动告诉它“ADB住在哪里”，这就涉及安装方式和环境变量两个环节，也是“mac adb配置”搜索需求长期存在的根本原因。
如果你之前用过Android Studio，可能发现SDK目录里其实自带platform-tools，但终端输入adb version依然报“command not found”，这说明文件在，但shell没找到，macOS默认使用zsh（自Catalina起），它只会在PATH变量指定的目录里找可执行文件，所以配置的实质就是改PATH。
安装ADB的三种方式对比
在动手之前,先明确一个概念：macOS上没有所谓的“安装ADB驱动”环节，这一点和Windows很不一样，Windows需要厂商驱动，macOS走的是系统自带USBMux通道，插上数据线就能识别，所以你在搜索引擎里看到的“mac adb配置驱动装不上”这类问题，基本是误传。
Homebrew安装（推荐）
Homebrew是macOS上的包管理器,类似Linux的apt-get，如果你还没装Homebrew，先执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
装完之后,安装ADB只需要一行：
brew install android-platform-tools
等待进度条跑完,ADB就藏在了/opt/homebrew/bin/（Apple Silicon）或/usr/local/bin/（Intel）目录下，Homebrew会自动完成PATH关联，多数情况下不需要手动改任何配置。
| 对比项 | Homebrew安装 | 手动下载platform-tools | Android Studio自带 |
|---|---|---|---|
| 命令易用度 | 一行命令 | 需手动解压+配PATH | 无需配置，但依赖IDE |
| 更新维护 | brew upgrade即可 |
需手动重新下载 | 随SDK Manager更新 |
| 磁盘占用 | 极小 | 约200MB | 随SDK整体占用 |
| 适合人群 | 多数用户 | 不喜欢包管理器的用户 | 已装Android Studio的开发者 |
手动下载platform-tools
去Android开发者官网下载适用于macOS的platform-tools压缩包，下载后解压，建议把解压出来的文件夹挪到一个固定位置，例如
~/platform-tools。
随后需要把它的路径加进shell配置里,这一步也叫“mac adb环境变量配置方法”，打开终端，执行：
echo 'export PATH="$HOME/platform-tools:$PATH"' >> ~/.zshrc source ~/.zshrc
然后测试adb version，如果输出版本号就说明生效了。
沿用Android Studio的SDK工具
已经装了Android Studio的话，不需要再装任何东西，找到SDK路径后配置即可，SDK默认位置是~/Library/Android/sdk，执行：
echo 'export PATH="$HOME/Library/Android/sdk/platform-tools:$PATH"' >> ~/.zshrc source ~/.zshrc
这条命令把platform-tools目录加到了PATH里，终端从此能直接调用adb。
环境变量配置的坑：zsh与bash的差异
macOS从Catalina开始默认shell改成了zsh,但网上大量教程还在写.bash_profile，如果你照着旧教程改完发现还是不生效，就是这个问题。
配置文件选哪个
- 当前用户用zsh：改
~/.zshrc - 当前用户用bash：改
~/.bash_profile - 不确定的话执行
echo $SHELL，输出/bin/zsh就是zsh
注意,~/.zshrc只在终端启动时加载，你改了文件之后，要么重启终端，要么执行source ~/.zshrc让它立刻生效。
验证是否生效
在终端依次执行以下命令,按顺序排查：
which adb adb version echo $PATH
which adb会打印出ADB的完整路径，如果它什么都没输出，说明PATH里没有ADB。echo $PATH查看当前PATH变量内容，看看刚才写的路径是否在列表里，这里有个常见误区：执行了source之后终端确实能看到改动，但关闭终端重新打开后如果又失效，大概率是配置文件写错了检查一下是不是把命令写进了.bash_profile但shell用的是zsh。
mac adb连接不上手机的排查步骤
装好ADB之后,插上Android手机，执行adb devices，这时候可能出现三种状态，对应三种完全不同的处理方式。
显示unauthorized
终端输出类似：
List of devices attached XXXXXXXXXXXX unauthorized
这说明手机和电脑已经建立了物理连接,但手机上没有允许调试授权，拿起手机，看屏幕是否弹出“允许USB调试吗？”的对话框，勾选“始终允许”，点击允许。
如果没弹出,检查手机“开发者选项”里的“USB调试”是否真的打开了，操作路径：设置 → 关于手机 → 连点“版本号”7次 → 返回设置 → 开发者选项 → 打开USB调试。
显示offline
这个状态意味着ADB能探测到设备,但通信异常，常见诱因按出现频率排序：
- 数据线质量差或接口松动,换一根原装线试试
- 手机锁屏后断开了USB调试,在开发者选项里开启“USB调试（安全设置）”或保持屏幕亮着
- 手机和电脑之间有其他ADB进程抢占端口
先跑一下adb kill-server再adb start-server重置服务，很多临时性的offline能靠这两条命令解决。
什么也不显示
adb devices列表为空，说明电脑压根没识别到设备，这时候从以下三个角度排查：
- 手机是否开启了“仅充电”模式，在通知栏把USB模式切换为“文件传输”
- 换一个USB接口,特别是MacBook的Type-C口，直接插或通过Hub转接差异较大
- 确认手机系统版本,Android 4.2.2以下版本没有USB调试功能，但这类设备现在已经很少见了
业内专家指出,mac adb配置过程中遇到的连接问题，超过半数最后都出在数据线和USB模式上，而非配置本身。
mac adb配置完成后常见报错整理
就算安装和配置步骤都走对了,实际操作时也难免撞上几个报错，下面按错误提示归类，给出一线排查思路。
command not found: adb
shell找不到adb命令,重新检查echo $PATH的输出里有没有platform-tools的路径，如果你用的是Homebrew方式，执行brew list android-platform-tools看包是否真的装上了，少数情况下Homebrew装完路径不在默认位置，执行brew --prefix android-platform-tools查实际安装目录，再手动写进.zshrc。
adb: command not found但which能找到
这个情况比较拧巴which adb能输出路径，但直接运行adb却报错，原因通常是zsh的hash缓存问题，执行hash -r清空缓存即可，行业共识认为这也是macOS终端比较常见的小毛病，不算配置错误。
端口占用导致adb无法启动
如果你电脑上装了多个安卓模拟器或手机助手类软件,可能出现：
adb server version (36) doesn't match this client (41); killing...
ADB的默认端口是5037,被其他程序占用时就会这样，解决办法是找到占用进程并结束它，然后重启ADB服务：
lsof -i:5037 kill -9 <PID> adb kill-server adb start-server
每次重启终端都要重新source
这属于配置文件本身没生效,不是“每次都要配”，检查~/.zshrc里写的export语句是否在文件末尾且语法正确，注意不要有多余空格，执行source ~/.zshrc后立刻打开一个新终端窗口测试，而不是在同一个窗口里测。
进阶：mac adb无线连接调试
有线连接偶尔会有线缆接触不良的烦恼,ADB也支持Wi-Fi无线调试，前提条件是手机和Mac处于同一个局域网内，操作很直接：
- 手机连上USB,开启USB调试
- 执行
adb tcpip 5555让设备在5555端口上监听 - 拔掉数据线,执行
adb connect 手机IP:5555 - 查看
adb devices，出现手机IP:5555 device即成功
手机IP地址可以在“设置 → WLAN → 当前网络”里查看，需要注意的是，无线调试在手机重启后会失效，需要重新走一遍流程，建议只在可信网络环境下使用，公共Wi-Fi下开启无线调试有被同一网络内其他设备连入的风险。
Q&A：mac adb配置常见问题解答
mac adb配置需要安装驱动吗
不需要,macOS内置了对Android设备USB调试的原生支持，不像Windows那样需要安装OEM USB驱动，你只需要开启手机上的开发者选项和USB调试，插上数据线就能被ADB识别。
为什么我改了.zshrc后adb还是不能用
先执行source ~/.zshrc，排除“没有重载配置”的可能，如果重载后能用、重启终端又失效，说明你改的不是当前shell适用的配置文件，执行echo $SHELL确认shell类型，zsh对应.zshrc，bash对应.bash_profile，还有一种可能：export语句写错了路径，执行echo $PATH检查路径字符串是否完整包含platform-tools位置。
用Homebrew装好adb还需要配置环境变量吗
多数情况下不需要,Homebrew安装的软件会自动在/opt/homebrew/bin或/usr/local/bin下生成软链接，这两个目录默认就在PATH里，如果执行adb version报错，执行brew list android-platform-tools确认安装成功，再用brew --prefix查看实际安装位置并手动加入.zshrc，最后一招可行但少见，多半是之前手动改过PATH导致默认目录被覆盖了。
配置ADB本身不难,难的是弄清楚自己的Mac用的是哪种shell、ADB文件实际放在了哪个路径，把这两个信息确认清楚，mac adb配置就成功了一大半，剩下的一半，交给adb devices去验证。