配置adb环境的核心步骤只有两个：下载Android Platform-Tools压缩包，把解压后的目录路径写入系统环境变量，Windows、macOS、Linux各有一套操作路径，但底层逻辑完全一致，配置完成后在终端输入adb version能返回版本号，就说明环境已就绪。
下载adb工具包：优先官网，避开完整版Android Studio
adb本身不是独立安装包,它包含在谷歌官方发布的 Platform-Tools 工具集中，很多人第一次配置会误下几个GB的Android Studio，其实只需要下载几十MB的platform-tools压缩包即可。
- 官方下载入口：在Android开发者官网搜索“SDK Platform-Tools”，进入下载页面。
- 页面会提供三个平台版本：Windows、macOS、Linux。
- 下载后得到一个zip压缩包,解压到固定目录，例如
D:\android-sdk\platform-tools或/Users/你的用户名/android-sdk/platform-tools。 - 不建议解压到需要频繁移动的临时目录,也不建议放在带中文或空格的路径下，否则后续终端解析路径时容易出问题。
据Android开发者官网说明,Platform-Tools包含adb、fastboot、systrace等命令行工具，其中adb用于与安卓设备通信，这个工具包版本会定期更新，配置环境变量后即使更换新版本，只要目录名不变，系统仍能正确调用。
win10怎么配置adb环境变量
Windows下配置adb环境变量的核心动作是把platform-tools目录追加到系统变量Path中，win11操作路径与win10基本一致，只是设置界面入口略有差异。
操作步骤
- 解压下载的platform-tools压缩包，记住解压后的完整路径，例如
D:\android-sdk\platform-tools。 - 按
Win + Pause打开系统信息窗口，点击左侧“高级系统设置”。 - 在弹出的“系统属性”窗口中点击“环境变量”按钮。
- 在“系统变量”区域找到
Path，双击进入编辑。 - 点击“新建”，粘贴
D:\android-sdk\platform-tools，点击确定保存。 - 打开一个全新的命令提示符窗口,输入
adb version，看到版本信息即配置成功。
adb环境变量配置不生效怎么办
这是Windows配置时最常见的卡点,多数情况下不是因为操作错误，而是终端没有重新加载环境变量。
- 先关掉旧的CMD或PowerShell窗口，环境变量在窗口打开时就被读取，旧窗口不会自动刷新配置。
- 输入
where adb确认系统能否定位到adb.exe，如果返回路径不在刚配置的目录，说明Path中还有其他包含adb.exe的旧路径，优先级更高。 - 检查路径是否包含中文、空格或特殊符号。
C:\Program Files\platform-tools这类带空格的路径有时需要手动加引号，但Path中一般不需要，仍建议换成无空格目录。 - 确认你修改的是“系统变量”中的Path，而不是“用户变量”中的Path，系统变量对当前机器的所有用户生效，用户变量仅对当前登录用户生效，某些精简版系统会优先读取用户变量，导致系统变量中的adb路径排在后面。
- 如果以上都无效,重启计算机是最终可靠方案，系统会强制刷新所有环境变量缓存。
mac配置adb环境变量教程
macOS配置adb环境变量主要使用终端和shell配置文件,新版macOS默认使用zsh，老版本使用bash，写入哪份文件取决于当前shell。
配置步骤
- 下载Mac版Platform-Tools并解压，例如放到
/Users/你的用户名/android-sdk/platform-tools。 - 打开终端,输入
echo $SHELL确认当前shell，返回/bin/zsh就编辑~/.zshrc，返回/bin/bash就编辑~/.bash_profile。 - 输入
vim ~/.zshrc进入编辑界面，按i进入插入模式，另起一行添加：export PATH=$PATH:/Users/你的用户名/android-sdk/platform-tools - 按
Esc退出插入模式，输入wq保存并退出。 - 执行
source ~/.zshrc让配置立即生效。 - 输入
adb version验证，能返回版本号即成功。
与Windows环境变量配置的对比
| 对比项 | Windows 10 | macOS |
|---|---|---|
| 配置文件位置 | 系统属性里的Path变量 | ~/.zshrc或~/.bash_profile |
| 配置方式 | 图形界面添加目录 | 命令行export路径 |
| 生效条件 | 新开终端或重启资源管理器 | source命令立即生效 |
| 常见卡点 | 旧终端未关闭、路径优先级 | 写错shell配置文件 |
行业内的共识是,macOS用户如果终端显示command not found: adb，八成原因是把export语句写进了错误的配置文件，或者修改后没有执行source命令。
安卓手机连接adb调试模式设置
配置好电脑端adb后,手机端也需要打开调试权限，否则adb devices会显示unauthorized或完全没有设备。
手机端开启步骤
- 进入手机“设置”，找到“关于手机”，连续点击“版本号”7次，直到出现“开发者模式已启用”提示。
- 返回设置主界面,进入“系统”或“更多设置”，找到“开发者选项”。
- 打开“USB调试”开关，部分手机还会弹出一个确认授权窗口，勾选“始终允许使用这台计算机进行调试”后点击确定。
- 使用数据线连接电脑,手机通知栏会出现“正在通过USB传输文件”，将模式切换为“文件传输/MTP”而非“仅充电”。
- 在电脑终端输入
adb devices，如果出现设备序列号且状态为device，说明手机端配置完成。
USB调试不显示设备的排查路径
- 换一根数据线,相当一部分线材只能供电不能传输数据。
- 换一个USB接口,优先使用主机后置USB口或Mac直连端口，避免经过扩展坞。
- Windows设备管理器里检查是否出现带黄色感叹号的“Android”或“便携设备”条目，如果有，说明缺少ADB驱动，需要安装设备制造商提供的USB驱动。
- 执行
adb kill-server后再执行adb start-server，重启adb服务。 - 部分安卓手机需要在开发者选项中额外打开“仅USB调试”或“USB安装”，不同品牌命名不同。
配置完成后必做的三件事
- 验证版本：输入
adb version，确认adb程序可被系统调用。 - 查看设备列表：输入
adb devices，确认设备状态为device而非unauthorized。 - 进入设备Shell：输入
adb shell，看到手机型号或提示符，说明通信通道正常。
这三步是判断adb环境是否配置成功的标准流程,任何一步报错都能反向定位到环境变量或手机调试权限问题。
adb环境配置常见问题Q&A
adb环境变量配置不生效怎么排查？
先关闭当前终端窗口再重新打开,输入where adb或which adb确认系统实际调用的adb路径，如果路径不含刚配置的目录，检查Path中的顺序或shell配置文件是否正确写入，再执行一次source命令或重启电脑。
win10和win11配置adb环境变量有区别吗？
核心操作没有区别,都是修改系统Path变量，win11的设置入口稍深，可直接通过任务栏搜索“环境变量”打开编辑窗口，后续步骤与win10完全相同。
adb命令找不到怎么解决？
终端提示command not found或不是内部或外部命令，说明系统PATH中不包含platform-tools目录，重新检查解压路径，将该路径追加到系统环境变量后重启终端，再执行adb version，如果仍找不到，检查目录下是否确实存在adb.exe或adb可执行文件，有时解压时多了一层文件夹，实际路径会变成platform-tools/platform-tools。
配置adb环境这件事,一半难度在下载对的工具包，另一半难度在让系统找到这个工具，把这两头都处理干净，后续的调试、安装、日志抓取都会顺畅很多。