mac怎么配置adb，adb环境变量怎么设置

在 macOS 上配置 ADB（Android Debug Bridge）并非复杂操作，但若想实现长期稳定、多设备协同、与云端构建流程无缝集成，仅靠一次性环境变量配置远远不够，本文将从基础安装、路径配置、常见故障到进阶的云端联动方案，给出可直接落地的完整指南,并分享酷番云在真实项目中的独家经验。

macOS 上安装 ADB 的三种主流方式

使用 Homebrew（推荐）

这是最省心、最易升级的方式,在终端执行：

brew install android-platform-tools

安装后自动将 adb 链接到 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），终端直接输入 adb version 即可验证。

下载 Android SDK Platform-Tools

从 Google 官方下载对应 macOS 的压缩包，解压后需手动配置环境变量，适合无法使用 Homebrew 的受限环境。

通过 Android Studio 内置 SDK

如果你已安装 Android Studio，其 SDK 目录下的 platform-tools 即包含 adb，但需要额外添加到 PATH,否则只能在特定目录下使用。

环境变量配置的完整细节

无论采用哪种安装方式，让 adb 命令全局可用是核心目标，推荐在 ~/.zshrc（macOS 默认 shell 已改为 zsh）中添加：

export PATH="$PATH:$HOME/Library/Android/sdk/platform-tools"

若使用 Homebrew 安装，通常无需手动添加，但若遇到 command not found,请执行：

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

验证技巧：在任意目录输入 which adb，若返回明确路径，说明配置成功，若返回空白，请检查 shell 配置文件是否加载正确,或终端是否需要重启。

真机调试与无线连接的专业配置

启用开发者模式

在 Android 手机上进入「关于手机」，连续点击「版本号」7 次，然后进入「开发者选项」，打开 USB 调试，不同品牌（小米、华为、三星）的入口可能有差异,但核心逻辑一致。

USB 连接与授权

用数据线连接 Mac 与手机，首次连接会弹出 RSA 密钥指纹授权框，勾选「始终允许」,然后输入：

adb devices

若显示 device 状态，即代表连接成功；若显示 unauthorized,请重新插拔并确认授权。

无线调试（Android 11+ 官方方案）

先通过 USB 连接并执行：

adb tcpip 5555
adb connect 手机IP:5555

之后即可拔掉数据线。注意：电脑与手机需处于同一局域网，且部分路由器 AP 隔离会导致失败。

高频故障的排错思路

adb: command not found

路径未正确写入 PATH，或写入后未执行 source，请检查当前 shell 是 zsh 还是 bash,按对应配置文件修改。

device unauthorized

手机端授权过期，重新插拔 USB，或进入开发者选项撤销 USB 调试授权,再次授权。

连接经常断开

• 使用原装数据线或高质量 USB 线
• 尝试电脑的其他 USB 接口（避免前置面板）
• 在开发者选项中开启「

  

  USB 调试（安全设置）」允许模拟点击等高级操作

多设备同时连接

在 adb devices 列出多台设备时,每条命令需指定序列号：

adb -s 设备序列号 shell

进阶：将 ADB 配置与云端构建流程联动（酷番云实践）

在实际项目中，我们经常遇到本地配置完美、但编译或自动化测试环境不统一的问题，酷番云在帮助开发者构建云端 Android 测试环境时,总结出一套可复用的经验：

经验案例：某团队需要每周在 10 台不同型号的 Android 真机上执行自动化回归测试，若每台 Mac 手动配置 adb，耗时且容易遗漏,酷番云的做法是：

• 将 adb 与 Fastlane、Jenkins 等自动化工具集成，通过脚本检测 adb 是否存在，若不存在则自动执行 brew install android-platform-tools
• 在云主机上预置统一的 ~/.zshrc 模板，确保所有构建节点的 PATH 完全一致
• 利用 adb reconnect offline 命令在设备掉线后自动重连，减少人工干预

这样做的核心收益是：将 adb 配置从“一次性手工操作”升级为“可版本化的基础设施”，即使后续新增构建节点或更换 Mac 电脑，也能在 5 分钟内恢复完整调试能力。

独立见解：不要忽视 adb 的版本一致性

很多开发者只关心能否连上手机，却忽略了 adb 服务端与客户端的版本差异，macOS 上 Homebrew 更新频繁，但手机上内置的 adb 版本可能较旧,导致某些新指令无法执行。

解决方案：避免同时安装多个 adb 副本，如果你的 Android Studio 自带一套 platform-tools，Homebrew 又装了一套，请用

which adb 确认实际生效的是哪一套，并保持统一,可以在终端定期执行：

brew upgrade android-platform-tools

但 不要盲目升级，先查看当前项目使用的 Gradle 插件版本是否兼容,以免破坏现有调试流程。

常见问题解答（FAQ）

Q1: 为什么我执行 adb devices 总是显示 offline？

解答：这通常是因为 adb 服务端版本与手机端不匹配，或 USB 连接不稳定，请先执行 adb kill-server 和 adb start-server 重启 adb 服务，然后换一个 USB 接口和原装数据线，如果仍然 offline，在手机上关闭 USB 调试再重新打开，最后重启手机，若以上均无效，检查电脑是否安装了第三方手机助手,它们可能占用端口冲突。

Q2: 在 Mac 上使用无线调试时，adb connect 提示无法连接，但局域网能 ping 通手机，是什么原因？

解答：大概率是手机端的 adb 服务未监听 5555 端口，你需要先用 USB 连接并执行 adb tcpip 5555，然后断开 USB 再执行 adb connect IP:5555，请确认手机上的「无线调试」开关（Android 11 以上会在开发者选项里单独提供）和「USB 调试」都已打开，部分手机还要求关闭「WLAN 省电模式」或「休眠时保持 WiFi 连接」，否则息屏后 adb 会断连。

如果你在配置过程中遇到其他奇怪问题，欢迎在评论区留言，我会根据实际经验协助排查,你的反馈也能帮助更多开发者少走弯路。