Linux 系统下 ADB 环境 的详细安装步骤和基础设置指南

独隅2026-03-31 10:43

Linux 系统下 ADB 环境 的详细安装步骤和基础设置指南

    • [第一步：安装 ADB 工具](#第一步：安装 ADB 工具)
      • [1. Ubuntu / Debian / Linux Mint / Kali](#1. Ubuntu / Debian / Linux Mint / Kali)
      • [2. Fedora / CentOS / RHEL](#2. Fedora / CentOS / RHEL)
      • [3. Arch Linux / Manjaro / EndeavourOS](#3. Arch Linux / Manjaro / EndeavourOS)
      • [4. 通用方法 (手动下载最新版)](#4. 通用方法 (手动下载最新版))
    • [第二步：配置 USB 权限规则 (关键步骤 ⚠️)](#第二步：配置 USB 权限规则 (关键步骤 ⚠️))
      • [方法 A：使用官方提供的 udev 规则脚本 (推荐)](#方法 A：使用官方提供的 udev 规则脚本 (推荐))
      • [方法 B：手动创建规则文件 (适用于包管理器安装)](#方法 B：手动创建规则文件 (适用于包管理器安装))
    • 第三步：基础使用与验证
    • [第四步：配置 Shell 环境变量 (可选)](#第四步：配置 Shell 环境变量 (可选))
    • 第五步：常用故障排查 (Linux 特有)
      • [1. 提示 `adb: command not found`](#1. 提示 adb: command not found)
      • [2. 提示 `no permissions` (最常见)](#2. 提示 no permissions (最常见))
      • [3. 手机连接后没有任何反应](#3. 手机连接后没有任何反应)
      • [4. 多个用户或权限冲突](#4. 多个用户或权限冲突)
      • [5. `???????????? no permissions`](#5. ???????????? no permissions)
      • [6. 设备管理器中看不到手机，或显示 `QHSUSB_BULK`](#6. 设备管理器中看不到手机，或显示 QHSUSB_BULK)
      • [7. `adb devices` 列表为空，但手机在充电](#7. adb devices 列表为空，但手机在充电)
      • [8. 无线调试 (WiFi) 连接失败](#8. 无线调试 (WiFi) 连接失败)
    • 第六步：无线调试 (无需 Root，无需特殊驱动)
    • 第七步：学习资源推荐
      • [1. 书籍推荐](#1. 书籍推荐)
      • [2. 线上资源与文档](#2. 线上资源与文档)
      • [3. 实践练习路线](#3. 实践练习路线)

本文详细介绍了在Linux系统下安装和配置ADB环境的完整步骤。针对Ubuntu/Debian、Fedora/CentOS和Arch Linux等主流发行版提供了不同的安装方法，重点讲解了关键的USB权限配置（包括官方脚本和手动规则设置两种方式）。文章还包含连接验证、环境变量配置、常见故障排查（如权限问题、设备识别失败等）以及无线调试方法。特别强调了Linux特有的权限设置要点，帮助开发者快速搭建完整的Android调试环境。

在 Linux 系统下配置 ADB (Android Debug Bridge) 环境通常比 Windows 更简单，因为大多数发行版都通过包管理器直接支持。

以下是针对 Ubuntu/Debian 、Fedora/CentOS 和 Arch Linux 的详细安装与配置指南，包含权限设置（这是 Linux 下最容易出错的地方）。

第一步：安装 ADB 工具

根据你的 Linux 发行版选择对应的安装命令。

1. Ubuntu / Debian / Linux Mint / Kali

使用 apt 包管理器：

bash 复制代码 
sudo apt update
sudo apt install adb fastboot

2. Fedora / CentOS / RHEL

使用 dnf 或 yum：

bash 复制代码 
# Fedora
sudo dnf install android-tools

# CentOS/RHEL (可能需要启用 EPEL 源)
sudo yum install android-tools

3. Arch Linux / Manjaro / EndeavourOS

使用 pacman：

bash 复制代码 
sudo pacman -S android-tools

4. 通用方法 (手动下载最新版)

如果软件源中的版本太老，可以手动下载 Google 官方最新版：

bash 复制代码 
# 1. 下载
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip -O platform-tools.zip

# 2. 解压到用户目录
unzip platform-tools-latest-linux.zip -d ~
unzip platform-tools.zip -d ~

# 3. 配置环境变量 (永久生效)
echo 'export PATH=$HOME/platform-tools:$PATH' >> ~/.bashrc
# 如果是 zsh
echo 'export PATH=$HOME/platform-tools:$PATH' >> ~/.zshrc

# 4. 刷新配置
source ~/.bashrc  # 或 source ~/.zshrc

第二步：配置 USB 权限规则 (关键步骤 ⚠️)

在 Linux 下，普通用户默认没有权限直接访问 USB 设备。如果不配置这一步，运行 adb devices 时会显示 ???????????? no permissions 或直接列表为空。

方法 A：使用官方提供的 udev 规则脚本 (推荐)

如果你是通过"通用方法"下载的官方包，里面包含了一个设置脚本：

bash 复制代码 
# 进入平台工具目录
cd ~/platform-tools

# 运行规则设置脚本 (需要 sudo)
sudo ./udev/setup_android_sdk_rules.sh

运行后需重新插拔手机或重启 udev 服务。

方法 B：手动创建规则文件 (适用于包管理器安装)

如果上述脚本不存在，请手动创建规则文件。

  1. 创建规则文件 ：

    bash 复制代码 
    sudo nano /etc/udev/rules.d/51-android.rules

  1. 填入以下内容 (涵盖主流厂商)：

    text 复制代码 
    # Google
SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"
# Samsung
SUBSYSTEM=="usb", ATTR{idVendor}=="04e8", MODE="0666", GROUP="plugdev"
# Xiaomi
SUBSYSTEM=="usb", ATTR{idVendor}=="2717", MODE="0666", GROUP="plugdev"
# Huawei
SUBSYSTEM=="usb", ATTR{idVendor}=="12d1", MODE="0666", GROUP="plugdev"
# OnePlus
SUBSYSTEM=="usb", ATTR{idVendor}=="2a70", MODE="0666", GROUP="plugdev"
# Sony
SUBSYSTEM=="usb", ATTR{idVendor}=="0fce", MODE="0666", GROUP="plugdev"
# LG
SUBSYSTEM=="usb", ATTR{idVendor}=="1004", MODE="0666", GROUP="plugdev"
# Motorola
SUBSYSTEM=="usb", ATTR{idVendor}=="22b8", MODE="0666", GROUP="plugdev"
# Generic
SUBSYSTEM=="usb", ATTR{idVendor}=="*", MODE="0666", GROUP="plugdev"

    注：MODE="0666" 表示所有用户可读写，最简单粗暴；更安全的方式是设置 GROUP="plugdev" 并将用户加入该组。

  1. 重载规则并重启服务 ：

    bash 复制代码 
    sudo udevadm control --reload-rules
sudo service udev restart
# 或者
sudo systemctl restart systemd-udevd

  1. 将当前用户加入 plugdev 组 (如果上面用了 GROUP) ：

    bash 复制代码 
    sudo usermod -aG plugdev $USER

    注意 ：加入组后需要注销并重新登录（或重启电脑）才能生效。

第三步：基础使用与验证

  1. 手机端设置 ：
    • 进入 设置 -> 关于手机 -> 连续点击 版本号 开启开发者模式。
    • 进入 开发者选项 -> 开启 USB 调试。
    • 用数据线连接电脑。
    • 手机上弹出"允许 USB 调试？"时，勾选"始终允许"并确认。

  1. 电脑端测试 ：

    bash 复制代码 
    adb devices

    • 成功输出 ：

      text 复制代码 
      List of devices attached
XM12345678    device

    • ❌ 失败 (no permissions) ：说明 udev 规则未生效。解决：检查是否已重启登录，或尝试拔掉重插 USB 线。

    • ❌ 失败 (列表为空)：检查数据线（是否仅充电）、USB 接口或手机是否开启调试。

    • 失败输出 (no permissions) ：

      • 检查是否执行了第二步。
      • 尝试拔掉数据线重插。
      • 运行 sudo adb devices 测试。如果 sudo 能识别但普通用户不行，说明权限规则未生效或用户未重新登录组。

第四步：配置 Shell 环境变量 (可选)

如果你使用的是手动下载的压缩包，或者想添加自动补全功能：

  1. 编辑配置文件 ：

    bash 复制代码 
    nano ~/.bashrc  # 如果是 zsh 则编辑 ~/.zshrc

  1. 添加路径 (仅手动安装时需要)：

    bash 复制代码 
    export PATH=$PATH:$HOME/platform-tools

  1. 添加自动补全 (提升体验) ：
    Android SDK 通常自带补全脚本。

    bash 复制代码 
    # 查找补全脚本位置 (通常在 platform-tools 目录下)
# 假设在 ~/platform-tools/completion
source ~/platform-tools/completion/adb.bash

    将 source 命令也加入 ~/.bashrc。

  1. 生效 ：

    bash 复制代码 
    source ~/.bashrc

第五步：常用故障排查 (Linux 特有)

1. 提示 adb: command not found

  • 确认已安装：which adb。
  • 如果是手动安装，确认 PATH 已导出并执行了 source。

2. 提示 no permissions (最常见)

  • 原因：udev 规则未加载或用户组未更新。
  • 解决 ：
    1. 检查规则文件是否存在：ls -l /etc/udev/rules.d/51-android.rules。
    2. 重新加载规则：sudo udevadm trigger。
    3. 彻底重启电脑（不仅仅是注销），确保用户组权限生效。
    4. 更换 USB 端口（有时前端面板供电不足或控制器不同）。

3. 手机连接后没有任何反应

  • 检查数据线是否仅支持充电。

  • 检查手机连接模式：下拉通知栏，将 USB 模式从"仅充电"改为"文件传输 (MTP) "或"PTP"。有些手机在 PTP 模式下 ADB 识别率更高。

  • 查看系统日志排查硬件识别问题：

    bash 复制代码 
    dmesg | grep -i usb

    观察插入手机时的最新日志，看是否有设备被识别。

4. 多个用户或权限冲突

  • 如果你同时使用了 Snap 或 Flatpak 安装的 Android Studio，它们可能有沙盒限制，无法访问宿主的 USB 设备。建议直接使用系统包管理器安装的 adb 命令行工具。

5. ???????????? no permissions

  • 原因：权限规则未加载或用户组未更新。
  • 解决 ：
    1. 运行 ls -l /dev/bus/usb/*/* 查看设备权限，确认是否有读写权限。
    2. 重新执行 sudo usermod -aG plugdev $USER 并彻底重启电脑。
    3. 临时测试：运行 sudo adb devices。如果 sudo 能识别，说明纯粹是权限问题。

6. 设备管理器中看不到手机，或显示 QHSUSB_BULK

  • 原因：手机进入了紧急下载模式（常见于高通芯片手机刷机失败），或驱动冲突。
  • 解决 ：
    • 如果是正常连接：尝试更换 USB 端口（优先使用主板后置 USB 2.0 接口）。
    • 如果是刷机变砖：需要安装 qpst 或 qfil 工具进行救砖（Linux 下有开源替代工具 edl）。

7. adb devices 列表为空，但手机在充电

  • 排查步骤 ：
    1. 数据线：换一根确认能传数据的线。
    2. USB 模式 ：下拉手机通知栏，将 USB 模式从"仅充电"改为 "文件传输 (MTP)" 或 "PTP"。有些手机在 PTP 模式下 ADB 兼容性更好。
    3. 系统日志 ：运行 dmesg -w 然后插入手机，观察是否有 USB 设备识别日志。如果没有，可能是硬件接口问题。
    4. 冲突软件：某些手机管家类软件会独占 ADB 端口，关闭它们。

8. 无线调试 (WiFi) 连接失败

  • Android 11+ ：支持纯无线配对。

    bash 复制代码 
    adb pair 192.168.1.5:37829  # 输入手机显示的配对码
adb connect 192.168.1.5:5555

  • 旧版本 ：必须先有线连接执行 adb tcpip 5555 才能切换无线。

  • 防火墙 ：检查 Linux 防火墙 (ufw 或 firewalld) 是否拦截了 5555 端口。

第六步：无线调试 (无需 Root，无需特殊驱动)

在 Linux 上，一旦配置好有线连接，无线调试非常方便：

bash 复制代码 
# 1. 有线连接状态下，开启 TCP 模式
adb tcpip 5555

# 2. 拔掉数据线，获取手机 IP (在 WiFi 设置里看，例如 192.168.1.5)
adb connect 192.168.1.5:5555

# 3. 验证
adb devices

注：Android 11+ 支持纯无线配对，无需先插线，使用 adb pair 命令即可。

第七步：学习资源推荐

ADB 只是工具，深入理解需要结合 Android 系统原理和 Linux 基础。

1. 书籍推荐

  • 入门实战 ：
    • 《第一行代码 Android (第3版)》 (郭霖 著)：国内最经典的入门书，虽侧重应用开发，但对环境搭建和基础调试讲解清晰。
    • 《Android 系统源码深入解析》：适合想深入理解 ADB 底层原理（如 JDWP, Transport 机制）的读者。
  • 进阶/底层 ：
    • 《Android System Programming》 (O'Reilly)：英文原版，深入讲解 Android 底层系统，包括 ADB 协议、Bootloader、Kernel 交互。
    • 《嵌入式 Linux 与 Android 驱动开发》：适合需要定制 ROM 或编写底层驱动的开发者。
  • Linux 基础 （ADB 在 Linux 下运行的基石）：
    • 《鸟哥的 Linux 私房菜》：经典中的经典，重点看"Shell 脚本"和"权限管理"章节。
    • 《Linux 命令行与 Shell 脚本编程大全》：提升使用 ADB Shell 的效率。

2. 线上资源与文档

  • 官方文档 ：
  • 优质博客/社区 ：
    • XDA Developers：全球最大安卓玩机社区，寻找特定机型的解锁、TWRP 和 ADB 教程。
    • CSDN / 掘金 / 知乎：搜索关键词"ADB 原理"、"Android 系统调试"，有很多国内大佬的实战文章（注意筛选发布时间，优先看 2024-2026 年的）。
    • GitHub 项目 ：
      • openandroidinstaller：开源的安卓安装器，代码中包含了大量处理 ADB/Fastboot 边缘情况的逻辑，值得阅读。
      • scrcpy：通过 ADB 控制安卓屏幕的神器，其源码展示了如何高效利用 ADB 传输数据。

3. 实践练习路线

  1. Level 1：在 Linux 上成功安装 ADB，连接手机，实现文件互传、安装 APK。
  2. Level 2 ：熟练使用 adb shell，使用 pm, am, dumpsys 等命令管理系统。
  3. Level 3：编写 Shell 脚本，自动化完成批量安装、日志抓取、性能测试。
  4. Level 4：尝试解锁 Bootloader，刷入自定义 Recovery (TWRP)，理解 Fastboot 协议。
  5. Level 5 ：阅读 ADB 源码，理解 adb server, adb daemon, host 之间的通信机制。

现在，你的 Linux 系统已经完全配置好 ADB 环境，可以进行开发、调试或刷机操作了！

相关推荐
码农爱学习2 小时前
使用cJosn读写配置文件
java·linux·网络
自然常数e2 小时前
预处理讲解
java·linux·c语言·前端·visual studio
哼？~2 小时前
Linux线程同步
linux
tumeng07112 小时前
Linux（CentOS）安装 Nginx
linux·nginx·centos
cyber_两只龙宝2 小时前
【Docker】Docker的原生网络介绍
linux·运维·docker·云原生·容器
AzusaFighting2 小时前
Dify (Ubuntu 24.04 Noble x64)部署教程
linux·运维·ubuntu
2301_805348972 小时前
MySQL源码编译部署主从及MHA高可用集群实战
adb
xlp666hub2 小时前
一篇文章彻底搞懂Linux驱动的并发控制与中断上下半部机制
linux·面试
木心月转码ing2 小时前
三个小技巧（commit message规范、代码格式化技巧、WSL开启网络代理）
linux
热门推荐
012026年3月AI领域大事件：DeepSeek引领开源风暴02GitHub 镜像站点03围棋-html版本04纯 HTML/CSS/JS 实现的高颜值登录页，还会眨眼睛！少女心爆棚！05班级宠物园部署指南06安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）07OpenClaw 使用和管理 MCP 完全指南08Mac 本地部署 OMLX + 通义千问 Qwen3.5-27B 保姆级教程09“wsl --install -d Ubuntu-22.04”下载慢，中国地区离线安装 Ubuntu 22.04 WSL方法（亲测2025年5月6日）10UV安装并设置国内源