在macOS上配置adb，核心就是安装包含adb的platform-tools并正确设置环境变量，整个过程5-10分钟即可完成。
adb作为Android开发者的日常工具,本身只是一个命令行程序，它不依赖Android Studio那样庞大的IDE，但需要确保系统能找到它的位置，很多人在Mac上折腾半天，问题往往出在环境变量没有生效，或者Shell配置写错了地方。
mac配置adb环境变量的核心步骤
第一步：确认你的Mac芯片类型
操作之前先分辨你的电脑是Apple Silicon还是Intel芯片，这个信息直接决定了工具链的兼容性，不过截至2026年，99%的官方工具都已原生支持两种架构。
- 点击左上角苹果图标,选择”关于本机”
- 芯片一栏显示”Apple M系列”即为Apple Silicon
- 显示”Intel”即为传统Intel处理器
第二步：Android工具链的获取方式
行业共识认为,最省心的方式是使用Homebrew包管理器安装，据长期维护Android开发环境的开发者反馈，这种方式能自动处理路径依赖，后续升级也方便。
如果尚未安装Homebrew,可以先安装它：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后,执行：
brew install android-platform-tools等待命令执行完毕,adb就会自动安装到/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel）目录下，此时直接在终端输入adb version，如果能看到类似”Android Debug Bridge version 1.0.41″的输出，说明已经可以直接使用了。
第三步：手动安装与路径配置
有些场景下无法使用Homebrew,比如公司网络受限，这时需要手动下载并配置。mac安装adb教程中，手动方式其实更直观因为你能看清每个文件被放到了哪里。
- 前往Android开发者官网下载”Command line tools only”压缩包（下载地址在developer.android.com）
- 解压后得到
cmdline-tools文件夹，将其移动到你希望存放的位置，比如~/Library/Android/ - 在
cmdline-tools目录下找到latest子目录，其中包含bin目录，里面就有sdkmanager
- 使用
sdkmanager安装platform-tools，或者直接将解压得到的platform-tools文件夹放到同一目录 - platform-tools目录下的
adb文件就是核心程序，记录这个路径以便后续配置
mac上adb命令怎么用
安装不是目的,能顺畅调用才是落点，Mac上调用adb目前主要有两种路径规划：临时使用和永久生效。
Bash与Zsh的配置差异
macOS从Catalina版本开始默认Shell从Bash切换到了Zsh,这个变化让不少旧教程失效，配置环境变量时，需要根据当前目录情况创建或修改对应的~/.zshrc文件。
如果platform-tools在~/Library/Android/platform-tools，那么在终端执行：
echo 'export PATH="$PATH:$HOME/Library/Android/platform-tools"' >> ~/.zshrc
source ~/.zshrc验证一下是否配置成功：
adb devices如果输出了List of devices attached，说明adb已经能正常响应命令，此时接上开启了USB调试的Android手机，就能看到设备序列号了。
常见配置路径对比
多用户切换场景要注意PATH的视角位置，有些开发者习惯用访客账号测试，结果发现刚配置的adb找不到了，正确地做法是：如果给当前用户配置，写在~/.zshrc即可；如果希望全系统可用，需要写到/etc/paths.d/目录下新建一个文件，里面直接写platform-tools的绝对路径。
mac adb连接手机出现unauthorized，这说明手机端的授权弹窗被忽略了，解决办法是在手机上重新拔插USB线，并在弹窗中勾选”始终允许使用这台计算机进行调试”，很多刚接触mac配置adb的开发者会忽略这个授权动作，导致后面执行adb install时总是报设备未授权。
mac adb环境变量配置报错的三种典型信号
command not found
终端输入adb后提示找不到命令，这通常意味着PATH配置没有正确持久化，检查步骤：确认~/.zshrc中是否真的写入了export行，然后执行echo $PATH查看当前会话中的PATH是否包含platform-tools路径，如果提交内容正确但尚未生效，执行source ~/.zshrc即可。
操作不允许
这个情况比较隐蔽,经常出现在macOS旧版本中，通常标示的是文件没有可执行权限，大多数情况下，从压缩包解压出来的adb文件默认是等保状态，需要用chmod +x命令手动给予执行权限，在platform-tools所在目录执行：
chmod +x adbadb找不到设备
Mac连接Android手机后输 出adb devices没有任何反应，绝大部分原因是驱动层面的授权问题，macOS系统对USB连接的Android设备需要信任证书证书，需要敲一下手机的信任提示框，再重新插拔连接线。
为Android Studio配置adb的正确姿势
安装了Android Studio但仍想在终端用adb的情况很常见。在mac上如果使用SDK安装方式需要注意：Android Studio自带的platform-tools位于/Users/你的用户名/Library/Android/sdk/platform-tools目录下，在终端输入adb如果出现版本信息但无法连接设备，需要确认当前项目中的SDK路径与自己配置的环境变量路径是否一致，在Android Studio的Project Structure中检查SDK Location，把对应路径复制到环境变量里就能对齐。
表格对比：两种adb配置方式
| 对比项 | Homebrew方式 | 手动SDK方式 |
|---|---|---|
| 安装耗时 | 约1分钟 | 约3分钟 |
| 更新频率 | 跟随brew源 | 手动下载 |
| 适合场景 | 日常开发 | 离线环境 |
| 路径位置 | /opt/homebrew/bin | ~/Library/Android/platform-tools |
| 易错点 | 需要先装brew | 路径容易配错在~/Downloads |
mac环境变量持久化的关键并不是写一行export，而是搞清楚当前Shell版本对应的rc文件位置，因为Zsh读取的是~/.zshrc，Bash读取的则是~/.bash_profile。 统一在Zsh下配置，能避免后续开关终端窗口时偶发的环境失效。
终端能识别adb但无法安装APK
这种情况大多与签名或协议版本有关,mac上adb的安装命令是adb install xxx.apk，如果APK与设备Android版本不匹配，会出现INSTALL_FAILED_OLDER_SDK的报错，市面上多数安卓模拟器的API版本需要与APK的targetSdkVersion大致对齐，参数不匹配时官方文档的提法是用
adb install --no-streaming绕过流式安装限制，多数模拟器环境下这个参数能解决连接失效的问题。
在这一步完成后,进入开发者目录里的remote设备查看，用adb shell切入设备内部，配合ls /data/app能看到实际占用空间的APK信息，若权限没有问题，配合adb uninstall就能自由控制安装了到设备上的应用。
Q&A：mac adb环境变量配置还有什么坑
Q：mac配置adb环境变量后，Python脚本调用adb时提示No such file or directory
A： 这种情况实际属性是权限传递问题，检查调用adb的父进程是否以管理员权限运行，推荐写法是在adb路径前加或将platform-tools目录完整写入到Python脚本的subprocess模块环境变量，macOS每次重启后自动重置临时目录，如果你的脚本对/data目录有读写要求，考虑在开机启动项中重新source一下rc文件。
Q：mac上close了Android Studio之后，adb操作就时露时断
A： 这个核心是adb服务被IDE独立线程控制导致的，在这种绑定场景下，即使换了端口从5037改成新地址，服务本身不会随某台计算机重新启动赋权，在Android Studio的Terminal面板执行adb kill-server，再在系统自己的终端执行adb start-server，服务就独立了。
Q：mac adb usb调试经常断开，重连也没有反应
A： 这类EK端问题常见于从Mac的Type-C口直接连接，因为部分Mac机型直连口的电压不够稳定用自带拓展坞或带供电的Hub可缓解，如果手机同时开了多个程序的无线调试授权，也会导致adb协议栈混乱，将开发者选项里的”无线调试”开关重新关闭再打开一次，大概率就恢复了。
整个mac配置adb的过程不算复杂,从安装platform-tools到shaping好PATH变量，本质是让系统在需要时能找到工具，牢记两个关键点：确认自己的Shell类型和写入路径时用绝对路径，就能避免装上却用不上的尴尬，mac adb排干扰时，先认真看报错代码再动手，按步骤走下来，就能在Mac上顺畅使用adb命令进行设备管理了。