ADB (Android Debug Bridge) 是 Android 開發、測試、運維的瑞士軍刀。本文整理 30+ 高頻核心命令,按場景分類 (設備連接、應用管理、文件同步、日誌系統、Shell 環境、系統屬性、網絡/端口、備份恢復、進階調試),附帶參數詳解、實用組合技、常見錯誤排查,桌面必備速查手冊。
adb devices [-l] # 列出設備 (-l 顯示產品/型號/傳輸ID)
adb devices | grep -w device # 僅顯示在線設備
adb get-state # 狀態: device/offline/unknown/bootloader/recovery
adb get-serialno # 獲取序列號
adb get-devpath # 獲取 USB 設備路徑
adb wait-for-device [-t timeout] # 等待設備在線 (腳本常用)
adb kill-server / adb start-server # 重啟 ADB 服務
adb version # 版本信息
adb help # 幫助
adb install [-r] [-d] [-g] [-t] # 安裝 (-r覆蓋 -d降級 -g授權所有權限 -t測試包)
adb install-multiple [-r] [-d] [-g] ... # 多 APK (分包/動態分發) 同時安裝
adb uninstall [-k] # 協載 (-k 保留數據/緩存)
adb shell pm list packages [-f] [-d] [-e] [-3] # 列出包 (-f含路徑 -d禁用 -e啟用 -3第三方)
adb shell pm path # 獲取 APK 路徑
adb shell pm dump # 完整包信息 (權限、組件、簽名、安裝源)
adb shell pm grant # 授權運行時權限 (API 23+)
adb shell pm revoke # 撤銷權限
adb shell pm enable/disable # 啟用/禁用應用 (需 root 或 shell 權限)
adb shell cmd package compile -m speed -f # AOT 編譯優化 (Profile Guided)
adb push # 電腦 → 手機 (目錄遞歸)
adb pull # 手機 → 電腦
adb sync [system|data|odm|oem] # 同步構建輸出目錄到設備 (編譯系統用)
# 示例
adb push ./app/build/outputs/apk/debug/app-debug.apk /sdcard/Download/
adb pull /sdcard/DCIM/Camera/ ./Photos/
adb shell ls -la /sdcard/ # 遠程列目錄
adb logcat [] # 實時日誌
adb logcat -v brief/time/color/long # 格式
adb logcat -b main/system/radio/events/crash/all # 緩衝區 (main主 system系統 radio無線 crash崩潰)
adb logcat -c # 清空緩衝區
adb logcat -d # 打印並退出 (非實時)
adb logcat -f -r -n # 循環寫文件 (大小/個數限制)
adb logcat -G # 設置緩衝區大小 (如 16M)
adb logcat -T '' # 從指定時間打印 (需配合 -d)
adb logcat --pid= # 過濾進程
adb logcat -s TAG:V TAG2:D *:S # 過濾標籤 (V/D/I/W/E/F/S) *:S 靜默其它
# 經典組合
adb logcat -v color -s MyTag:D *:S # 彩色輸出指定標籤
adb logcat -b crash -d # 導出崩潤日誌
adb shell # 進入交互式 Shell (Linux 環境)
adb shell # 執行單條命令並退出
# 常用 Shell 子命令
adb shell dumpsys # 系統服務狀態傾印 (battery, activity, window, package, meminfo, gfxinfo, usagestats)
adb shell dumpsys activity activities # 查看 Activity 棧/任務
adb shell dumpsys batterystats # 電池統計 (生成 bugreport 核心)
adb shell dumpsys meminfo # 進程內存詳情 (PSS, Private Dirty, Heap)
adb shell dumpsys gfxinfo # 幀率/繪製性能數據
adb shell ps -A / ps -ef # 進程列表
adb shell top -n 1 -d 1 # 實時 CPU/內存 (類 top)
adb shell kill # 殺進程
adb shell am start -n pkg/.Activity # 啟動 Activity (Intent 完整支持)
adb shell am broadcast -a ACTION # 發送廣播
adb shell am force-stop # 強制停止應用
adb shell pm clear # 清除應用數據 (相當卸載重裝保留 APK)
adb shell input text "string" # 模擬輸入文本
adb shell input tap x y / swipe x1 y1 x2 y2 duration # 模擬點擊/滑動
adb shell screencap -p /sdcard/sc.png # 截圖
adb shell screenrecord /sdcard/vid.mp4 # 錄屏 (限 3分鐘/4Mbps)
adb shell settings put global # 修改全局設置 (如 stay_on_while_plugged_in=3)
adb shell getprop / setprop # 系統屬性讀寫 (ro.build.version.sdk 等)
adb forward tcp: tcp: # TCP 轉發 (本地:設備)
adb forward --remove tcp: # 移除轉發
adb forward --list # 列出轉發
adb reverse tcp: tcp: # 反向轉發 (設備訪問電腦服務, API 21+)
# 典型用例
adb forward tcp:8080 tcp:8080 # 手機訪問電腦 8080 服務
adb reverse tcp:9222 tcp:9222 # Chrome DevTools 遠程調試 WebView
adb reverse tcp:8080 tcp:8080 # 手機 App 訪問電腦 Mock Server
adb backup [-f ] [-apk|-noapk] [-obb|-noobb] [-shared|-noshared] [-all] [-system|-nosystem]
adb restore
# 現代替代:應用內導出/雲同步 / adb shell bu backup/restore (新備份框架 API 24+)
# Systrace / Perfetto 系統級追蹤
adb shell atrace --async_start -b 32768 -c sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory
# ... 操作 ...
adb shell atrace --async_stop -o trace.perfetto-trace
adb pull /data/misc/perfetto-traces/trace.perfetto-trace . # 在 UI.perfetto.dev 分析
# GPU Inspector (AGI) 圖形幀分析
adb shell setprop debug.agi.enable 1
# AGI Desktop 連接分析
# 內存分析
adb shell am dumpheap /data/local/tmp/heap.hprof
adb pull /data/local/tmp/heap.hprof .
# 用 Android Studio Profiler / MAT / jhat 分析
# SQLite 數據庫操作
adb shell
sqlite3 /data/data/pkg/databases/db.db ".schema"
sqlite3 /data/data/pkg/databases/db.db "SELECT * FROM table;"
# SELinux 策略查看
adb shell sesearch --allow -s untrusted_app -t app_data_file -c file
| 錯誤 | 原因 | 解決 |
|---|---|---|
| error: device unauthorized | 未授權 USB 調試 | 手機彈窗點「允許」/ 撤銷授權重試 |
| error: device offline | 連接斷開/ADB 服務異常 | adb kill-server; 插拔線; 重啟手機 ADB |
| cannot bind 'tcp:5037' | 端口被佔用 | 殺佔用進程/改端口/關衝突軟件 |
| INSTALL_FAILED_ALREADY_EXISTS | 應用已存在 | adb install -r (覆蓋) / 先 uninstall |
| INSTALL_FAILED_VERSION_DOWNGRADE | 版本號降級 | adb install -d (允許降級) / 先 uninstall |
| INSTALL_FAILED_TEST_ONLY | 測試包 | adb install -t |
| Permission denied (shell cmd) | 無權限 (需 root 或特定權限) | root / 使用 run-as pkg / 檢查導出組件 |
建議將此表導出為 PDF/Markdown 置於工位,遇到問題秒級定位命令。熟練掌握 dumpsys, logcat, forward/reverse, shell am/pm 組合拳,是 Android 工程師的基本功。