Mac上除了Homebrew，这几种安装ADB的方法你可能也需要知道（含手动配置避坑）-程序员充电站

Mac上五种ADB安装方案全解析：从Homebrew到手动配置的终极指南

当你在Mac上调试Android设备时，突然发现adb devices命令返回"command not found"，这种挫败感我深有体会。作为与Android设备通信的生命线，ADB（Android Debug Bridge）的安装本应简单直接，但现实往往充满变数——Homebrew版本冲突、网络问题、系统兼容性，每一个环节都可能成为拦路虎。本文将带你突破单一安装方式的局限，系统梳理五种经实战验证的ADB安装方案，特别针对High Sierra等老旧系统提供专属解法，并深入解决环境变量配置这个高频痛点。

1. 为什么需要了解多种ADB安装方式

去年在为客户部署自动化测试环境时，我遇到一个典型案例：团队统一使用Homebrew安装ADB，但当新成员加入时，由于Homebrew的cask命令格式变更导致安装失败，整个项目进度被耽误半天。这个教训让我意识到，过度依赖单一安装路径存在隐性风险。

目前主流Mac设备面临的ADB安装挑战主要来自三个方面：

系统版本碎片化：从Catalina到最新的Sonoma，每个macOS版本对开发工具的支持度不同
网络环境不稳定：Homebrew源服务器访问困难，尤其在国内网络环境下
工具链变更频繁：Homebrew等工具自身更新可能破坏原有安装流程

下表对比了不同安装场景的典型痛点：

场景	主要问题	影响范围
Homebrew安装失败	源服务器不可达/命令格式变更	80%的初级开发者
Android Studio捆绑	安装包过大/需要图形界面	设计转开发人员
手动下载platform-tools	路径配置复杂/版本管理困难	运维人员
旧系统兼容	缺少预编译二进制文件	High Sierra用户
多版本共存	环境变量冲突	跨项目开发者

接下来，我们将从最简方案到高级配置，逐层深入各安装方法的实操细节与避坑指南。

2. Homebrew方案：便捷与风险的平衡

作为Mac上最受欢迎的包管理工具，Homebrew安装ADB理论上只需一行命令：

brew install android-platform-tools

但实际执行时你可能遇到这些典型问题：

常见报错与解决方案：

Error: Unknown command: cask
- 原因：Homebrew 2.5.11+版本移除了--cask参数
- 解决：直接使用brew install android-platform-tools
Error: No available formula with the name "android-platform-tools"
- 原因：本地brew仓库过期
- 解决：先执行brew update

下载速度极慢或超时

推荐使用国内镜像源：

# 替换Homebrew源 git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git # 替换Homebrew-core源 git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

对于macOS High Sierra等老旧系统，还需特别注意：

从Homebrew 3.0开始不再为High Sierra提供预编译二进制包，必须添加--build-from-source参数从源码编译，耗时可能超过30分钟。

验证安装成功的正确姿势：

adb version # 预期输出：Android Debug Bridge version 1.0.41 # 而非简单的"adb: command not found"

3. Android Studio内置方案：一站式解决但体积庞大

如果你同时需要Android开发环境，通过Android Studio安装可能是更合理的选择。具体路径：

启动Android Studio
打开Preferences > Appearance & Behavior > System Settings > Android SDK
在SDK Tools标签页勾选"Android SDK Platform-Tools"

优势：

自动处理所有依赖项
图形界面操作直观
方便后续SDK版本更新

劣势：

完整安装包超过1GB
需要Java环境支持
不适合仅需ADB的自动化场景

安装后需检查SDK路径是否加入环境变量，通常位于：

~/Library/Android/sdk/platform-tools

4. 手动下载platform-tools：最可靠的保底方案

当其他方法都失效时，手动下载永远是最可靠的备用方案。以下是经过优化的操作流程：

# 1. 下载最新版（替换URL中的darwin为linux或windows可跨平台） curl -OL https://dl.google.com/android/repository/platform-tools-latest-darwin.zip # 2. 解压到标准化路径（避免随意存放导致后续找不到） unzip platform-tools-latest-darwin.zip -d ~/.android/ # 3. 配置环境变量（针对zsh用户） echo 'export PATH=$PATH:~/.android/platform-tools' >> ~/.zshrc source ~/.zshrc

路径选择的三个黄金准则：

避免使用含空格的路径（如/Applications/My Tools/）
推荐隐藏目录（如.android/）减少误删风险
保持路径一致性便于团队协作

对于企业环境，可以考虑将platform-tools放入共享目录：

# 网络路径示例 ln -s /Volumes/Company-Share/dev-tools/platform-tools ~/.android/platform-tools

5. 旧系统特别方案：MacPorts与源码编译

面对High Sierra等已停止支持的系统，我有两个经生产验证的方案：

方案A：使用MacPorts替代Homebrew

# 安装MacPorts curl -OL https://distfiles.macports.org/MacPorts/MacPorts-2.7.2-10.13-HighSierra.pkg sudo installer -pkg MacPorts-2.7.2-10.13-HighSierra.pkg -target / # 通过MacPorts安装 sudo port install android-platform-tools

方案B：从AOSP源码编译

git clone https://android.googlesource.com/platform/system/core cd core/adb make -j4

源码编译需要Xcode命令行工具，执行xcode-select --install安装

6. 环境变量配置：90%问题的根源

无论采用哪种安装方式，环境变量配置都是最后的临门一脚。以下是诊断问题的标准流程：

确认ADB实际路径

# Homebrew安装路径 brew --prefix android-platform-tools # 手动安装查找 find ~ -name adb -type f 2>/dev/null

检查当前Shell环境

echo $SHELL # /bin/zsh => 修改.zshrc # /bin/bash => 修改.bash_profile

多环境变量文件处理顺序
```
~/.zprofile → ~/.zshrc → ~/.profile
```

对于高级用户，推荐使用path_helper统一管理路径：

# 在/etc/paths.d/下创建android-tools文件 echo '/Users/yourname/.android/platform-tools' | sudo tee /etc/paths.d/android-tools

7. 多版本管理与自动化部署

在持续集成环境中，我推荐使用Docker方案保证环境一致性：

FROM ubuntu:20.04 RUN apt-get update && apt-get install -y android-sdk-platform-tools ENV PATH=$PATH:/usr/lib/android-sdk/platform-tools

本地多版本切换则可用符号链接实现：

# 创建版本目录结构 mkdir -p ~/android-sdk/versions/{31.0.3,33.0.1} # 切换版本 ln -sf ~/android-sdk/versions/33.0.1 ~/.android/platform-tools

最后分享一个真实案例：某金融App团队因为CI服务器上的ADB版本过旧，导致自动化测试覆盖率数据异常。解决方案是在构建脚本中加入版本校验：

MIN_ADB_VERSION="1.0.41" ACTUAL_VERSION=$(adb version | awk '/version/{print $4}') if [ "$(printf '%s\n' "$MIN_ADB_VERSION" "$ACTUAL_VERSION" | sort -V | head -n1)" != "$MIN_ADB_VERSION" ]; then echo "Error: ADB version too old (require >=$MIN_ADB_VERSION)" exit 1 fi