Mac上如何配置ADB环境变量？安卓开发必备教程

Mac 上配置 ADB，关键在于环境变量的正确设置与命令的即时验证

无论你是刚接触 Android 开发的新手，还是需要频繁调试设备的资深工程师，在 Mac 上完成 ADB（Android Debug Bridge）配置都是高效工作的基础，ADB 本身只是一个命令行工具，但很多人卡在“装好却无法全局调用”这一步。本文给出最直接、最稳定的配置路径，并解决最常见的坑，确保你配置后可以立即在终端中输入 adb devices 识别设备。

ADB 是什么，为什么必须在 Mac 上单独配置

ADB 是 Android 官方提供的调试工具，它通过 USB 或 Wi-Fi 与安卓设备通信，实现安装应用、抓取日志、模拟点击、传输文件等操作，macOS 不会自带该工具，因此需要先下载 Android SDK 平台工具,再让系统找到这些命令。

核心逻辑只有两步： 下载平台工具，然后将其所在目录加入系统的 PATH 环境变量，只要这两步做对,后续所有命令都能在任意终端窗口直接使用。

前置条件：确认 Mac 的芯片类型与环境准备

在开始之前，请先确认你的 Mac 是 Apple Silicon（M1/M2/M3）还是 Intel 芯片，因为下载的 SDK 版本没有区别，但后续若涉及 Homebrew 安装时,路径会有差异。

推荐两种安装方式,按需选择：

• 方式 A：通过 Homebrew 安装（适合喜欢包管理的用户）
• 方式 B：手动下载官方平台工具（适合追求纯净、不想额外安装依赖的用户）

两种方式最终效果一致，本文会给出优先推荐的方案,并对另一方案做简要说明。

详细配置步骤（以手动下载官方工具为例）

获取最新平台工具

访问 Android 开发者官网的「SDK Platform Tools」下载页面（developer.android.com/tools/releases/platform-tools），选择对应 macOS 的 ZIP 包（文件名类似 platform-tools-latest-darwin.zip）。不要下载 Windows 或 Linux 版本。

下载完成后，双击解压，得到一个名为 platform-tools 的文件夹，里面包含 adb

、fastboot 等可执行文件。

将文件夹移动到固定位置

建议将这个文件夹放到用户目录下的隐藏文件夹中，方便管理且不易误删，打开终端,依次执行：

mkdir -p ~/Library/Android/sdk
mv 下载的路径/platform-tools ~/Library/Android/sdk/

把 下载的路径 替换成你实际的解压位置，更好的做法是直接在你的「下载」文件夹中拖拽到终端里生成路径,避免手打错误。

配置环境变量（关键步骤）

macOS 默认使用 zsh（Catalina 及以后版本），所以需要编辑 ~/.zshrc 文件，如果使用 bash，则编辑 ~/.bash_profile,执行：

echo 'export PATH="$PATH:$HOME/Library/Android/sdk/platform-tools"' >> ~/.zshrc
source ~/.zshrc

第一条命令将路径写入配置文件，第二条命令让配置立即生效。注意： 如果你将来重新安装系统或切换终端工具（如 iTerm2），只需重新执行 source ~/.zshrc 即可。

验证是否成功

在终端中输入：

adb version

如果输出版本号，Android Debug Bridge version 1.0.41，说明配置成功，如果提示 command not found，请检查路径是否与配置文件中的完全一致,或重新执行上述命令。

连接设备并测试

用 USB 线连接安卓手机，在手机设置中找到「开发者选项」，开启「USB 调试」，首次连接时，手机会弹出授权窗口，勾选「允许」后点击确定,然后在终端输入：

adb devices

你应当看到类似：

List of devices attached
XXXXXXXX    device

如果显示 unauthorized，需要在手机上重新确认授权；如果显示 offline，请更换 USB 线或重新插拔。

常见问题与专业解决方案

配置命令无法生效，提示“source: command not found”

这不是配置错误，而是你当前的终端是 sh 或 fish，请先切换到 zsh（执行

chsh -s /bin/zsh），然后重新开启终端窗口。务必在 zsh 环境下配置,否则更改无法持久化。

超时连接真机，使用 Wi-Fi 模式更快

USB 线不稳定，可使用无线调试，Mac 和手机连接同一局域网，手机端开启「无线调试」，然后用 adb connect 手机IP:端口 连接。推荐先用 USB 连接，输入 adb tcpip 5555 开启临时网络调试功能，再断开 USB，通过 IP:5555 连接,这一方法在频繁插拔设备时非常高效。

adb 命令正常，但某些模拟器（如 Genymotion）不识别

模拟器通常有专属的桥接工具，需要单独配置，但如果你使用的是 Android 自带的模拟器，只需保证 SDK 平台工具的版本与模拟器的 API 级别匹配。如果遇到 adb server version doesn't match this client，说明同时运行了多个版本的 adb，解决办法是杀掉所有 adb 进程,只保留最新的：

adb kill-server
adb start-server

独家经验案例：当 adb 遭遇服务器连接问题时，如何借用云服务器快速定位

实际开发中，我们团队曾遇到一个棘手场景：本地 Mac 能正常执行 adb devices，但执行 adb shell 时频繁断开，并且报错 “closed”，排查半天发现并非 Mac 配置问题，而是 Android 系统自身的 adb 服务不稳定。

我们利用酷番云的 Linux 云服务器（轻量应用服务器）部署了一个辅助监控脚本，通过云端的公网 IP 与本地设备建立反向端口映射，从而区分是本地网络问题还是设备问题,具体做法是：

• 在 Mac 上运行 adb forward tcp:7777 tcp:5555
• 同时在酷番云服务器上用 nc 监听对应端口，模拟连接测试

结果发现本地网络一切正常，最终确认为设备端 ROM 的 adb daemon 异常，重启设备后恢复。这一思路的价值在于：遇到疑难杂症时，用一台云服务器作为参照物，就能迅速将问题边界缩小到设备端或传输链路，而不是反复折腾本地配置。

对于需要远程调试安卓设备的开发者，酷番云还提供稳定的公网带宽和低延迟线路，配合 ADB over TCP/IP 模式，可以实现跨地域的设备调试。即使你的 Mac 不在设备旁边，只要设备接入网络且开启无线调试，就能通过云端中转完成远程操作,大大提升工作效率。

相关问答模块

问：我按照教程配置了 ADB，但每次关闭终端后再次打开，adb 命令又失效了，怎么办？

答：这通常是因为你只修改了当前会话的环境变量，没有写进配置文件，请确认执行过 echo 'export PATH="$PATH:$HOME/Library/Android/sdk/platform-tools"' >> ~/.zshrc，并且后续新开的终端窗口都基于 zsh，如果你使用了终端管理器（如 Terminal.app 的「新建窗口」），该命令会自动加载 .zshrc，检查方法：输入 echo $PATH，看输出中是否含 platform-tools，若没有，重新执行写入操作并 source ~/.zshrc。注意：不要重复叠加写同一行，否则 PATH 中会出现多个相同路径，不影响使用但不够整洁。

问：连接手机后 adb devices 显示 offline，如何解决？

答：offline 状态意味着 ADB 无法与设备正常通信，首先尝试 adb kill-server && adb start-server 重启 ADB；然后在手机上撤销调试授权（开发者选项中找到「撤销 USB 调试授权」），重新连接并再次确认，如果仍然无效，检查 USB 数据线是否支持数据传输（部分线只能充电），并尝试更换 Mac 上的 USB 接口。最后手段是重启手机和 Mac 的 ADB 服务，多数情况下都可以解决，如果问题依旧，可以考虑使用 Wi-Fi 调试替代,具体参考上文第四部分。

如果你在配置过程中还有其他奇怪问题，或者有更好的调试技巧，欢迎在评论区留言交流，你也可以分享自己设备型号和错误提示，大家一起探讨解决。顺手点个收藏，以后重新装系统或换新 Mac 时，按这篇步骤一步步操作，两分钟就能搞定。