ADB 显示 unauthorized、offline 或无设备？实用 USB 调试排查清单

adb devices 的输出已经告诉你哪一层连接失败，而不是先去重装驱动。当结果是 unauthorized、offline、空列表或 ADB 未识别时，排查顺序应从工具、线缆、USB 模式、授权到驱动依次进行。这个 checklist 针对 Windows、Mac 和 Linux 平台，特别适合小米、华为、OPPO 等国产手机用户处理 USB 调试问题。

ADB 命令未被识别时先检查安装与 PATH

终端直接报 “adb: command not found” 或 “‘adb’ 不是内部或外部命令” 时，问题出在 ADB 本身没有被系统找到。这一步必须放在最前面，否则后面所有命令都无法执行。

Windows 用户打开 PowerShell 或 CMD，输入 where adb。如果没有任何输出，说明未加入 PATH。最稳妥的做法是下载 platform-tools 最新包，解压后把整个文件夹路径添加到系统环境变量。右键此电脑→属性→高级系统设置→环境变量，在 Path 中新增对应目录，重启终端后再运行 adb version 验证。

Mac 用户通常通过 Homebrew 安装，执行 brew install android-platform-tools 即可。安装完成后运行 adb version，如果仍提示未找到，则执行 echo 'export PATH="$HOME/Library/Android/sdk/platform-tools:$PATH"' >> ~/.zshrc 并 source ~/.zshrc。部分用户使用 Android Studio 自带的 SDK，路径可能在 ~/Library/Android/sdk/platform-tools。

Linux 用户推荐通过包管理器安装：Ubuntu/Debian 执行 sudo apt install android-tools-adb android-tools-fastboot，Fedora 用 sudo dnf install android-tools。安装后运行 which adb 确认路径，通常在 /usr/bin/adb。如果使用手动解压的 platform-tools，记得把路径加入 ~/.bashrc 或 ~/.zshrc。

这一步解决后，终端能正常识别 adb 命令，才可以继续往下排查设备连接。很多开发者卡在这一步却直接去重装驱动，浪费了大量时间。

设备列表为空通常指向线缆或 USB 模式

运行 adb devices 后什么都不显示，最常见的原因是物理连接没有建立。国产手机在这方面表现尤其明显。

首先确认手机已开启 USB 调试。小米手机需要在设置→关于手机里连续点击 MIUI 版本 7 次进入开发者选项，然后打开 USB 调试和 USB 调试（安全设置）。华为手机同样需要打开开发者选项，额外开启「允许 ADB 调试」和「USB 调试」。OPPO 和 vivo 手机的路径类似，但部分机型还需在开发者选项里关闭「默认 USB 配置」里的「仅充电」选项。

线材选择也很关键。很多用户习惯用手机原装充电线，但部分原装线只支持充电不支持数据传输。建议换一条已知可用的数据线，最好是原装或质量较好的第三方数据线。把手机插到电脑 USB 端口后，手机屏幕应弹出「允许 USB 调试」或「充电中」提示。如果只显示充电而不弹出任何选项，说明线材或端口仅支持供电。

在电脑端运行 lsusb（Mac/Linux）或 adb devices 观察。Windows 用户可在设备管理器中查看「便携设备」或「其他设备」下是否出现未知设备。如果列表仍为空，尝试更换 USB 端口，优先使用主板后置 USB 2.0 口而非 USB 3.0 或 Type-C 扩展坞。

unauthorized 状态需在手机端确认 RSA 授权

adb devices 显示设备序列号后面跟着 “unauthorized”，说明电脑没有获得手机的 RSA 密钥授权。

解决方法是在手机端操作。当手机连接电脑后，屏幕上会弹出对话框询问「允许此电脑进行 USB 调试吗？」。必须勾选「始终允许来自这台计算机的调试」然后点击确定。如果之前点过「取消」，就需要彻底清除授权记录。

小米手机可在开发者选项里找到「撤销 USB 调试授权」并点击。华为手机同样在开发者选项里有「撤销 ADB 调试授权」或直接重启手机。OPPO 手机有时需要进入设置→应用管理→找到系统 UI 或设置，清除其数据才能重新弹出授权框。

清除后重新插拔数据线，授权弹窗应再次出现。部分用户反映在 Mac 上授权后仍显示 unauthorized，这时可以在终端执行 adb kill-server 然后 adb start-server，再重新授权。

如果手机端已经勾选始终允许，但电脑端仍显示 unauthorized，可能是密钥文件损坏。Linux 和 Mac 用户可以删除 ~/.android/adbkey 和 adbkey.pub 两个文件，Windows 用户删除 %USERPROFILE%\.android 目录下的对应文件，然后重新授权。

offline 状态多因连接中断或权限冲突

显示 “offline” 表示设备曾经连接过，但当前连接已中断或状态异常。

最快速的修复是拔掉数据线，等待 10 秒后重新插入，同时在手机上再次确认 USB 调试开关处于打开状态。很多情况下只需执行 adb kill-server 再 adb start-server 就能恢复。

权限冲突是另一个常见原因。Linux 用户经常遇到权限不足问题，运行 ls -l /dev/bus/usb/* 查看设备权限，如果所属组不是 plugdev，需要把当前用户加入 plugdev 组：sudo usermod -aG plugdev $USER 然后重新登录。

Windows 下驱动冲突也容易导致 offline。设备管理器中如果看到安卓设备带有黄色感叹号，需要更新或回滚驱动。华为和小米手机常出现与手机管家自带驱动冲突的情况，建议先卸载手机管家再尝试连接。

进阶命令包括 adb reconnect 和 adb usb。前者尝试重新建立连接，后者强制设备切换到 USB 模式。执行这些命令后再次运行 adb devices 查看状态变化。

Windows 下驱动冲突的针对性排查顺序

Windows 是国产手机用户遇到驱动问题最多的平台。排查顺序应遵循：设备管理器→驱动状态→官方驱动→冲突软件。

打开设备管理器，展开「Android Device」或「其他设备」。如果看到 “Android Composite ADB Interface” 带有黄色三角，右键选择「更新驱动程序」→「浏览计算机查找驱动程序」，指向 platform-tools 目录下的 driver 文件夹。

小米用户推荐安装小米 USB 驱动，华为用户使用 HiSuite 自带驱动，OPPO 用户可从官网下载 ColorOS USB 驱动。安装完成后重启电脑，再次运行 adb devices。

如果仍无效，检查是否安装了多个手机助手软件。360 手机助手、豌豆荚、QQ 手机管家等都会安装自己的 ADB 驱动，容易冲突。建议卸载所有第三方手机管理软件，只保留官方驱动。

命令行验证可以使用 adb devices -l 查看更详细的设备信息。如果显示 transport_id 但状态仍是 offline，可尝试以管理员身份运行命令提示符再执行 adb start-server。

Mac 与 Linux 的权限设置与预防措施

Mac 用户主要面对权限和开发者模式问题。新版 macOS 会要求用户在「安全性与隐私」中允许 ADB 访问。系统偏好设置→安全性与隐私→通用，如果看到 “Android File Transfer” 或 ADB 相关提示，点击允许。

Linux 用户除了前面提到的 plugdev 组，还需要确保 udev 规则正确。创建文件 /etc/udev/rules.d/51-android.rules，写入常见国产手机的 Vendor ID，例如小米 ATTR{idVendor}=="05c6", MODE="0666", GROUP="plugdev"，华为 ATTR{idVendor}=="12d1" 等。保存后执行 sudo udevadm control --reload-rules && sudo udevadm trigger。

预防措施比排查更重要。长期使用建议固定一条高质量数据线，避免频繁插拔同一端口。每次连接前先运行 adb devices 观察状态，养成在手机端及时处理授权弹窗的习惯。

对于需要反复调试的开发者，可以使用 adb tcpip 5555 命令开启无线调试，之后通过 WiFi 连接，避免反复插拔数据线导致的 offline 和 unauthorized 问题。设置完成后即使拔掉 USB 线也能保持连接，显著降低故障发生频率。

掌握这个分层排查顺序后，大部分 ADB 连接问题都能在 5 分钟内定位解决，而不是盲目重装驱动或重启电脑。

参考来源