IntelliJ IDEA ADB 連接失敗排查指南

常見現象

• IDEA 顯示 "ADB connection failed" 或設備列表為空
• 任務管理器無 `adb.exe` 進程
• 終端執行 `adb devices` 無輸出或報錯

核心排查步驟

1. 檢查 ADB 可執行文件路徑

# Windows
where adb
# 輸出示例: C:\Users\xxx\AppData\Local\Android\Sdk\platform-tools\adb.exe

# Linux/Mac
which adb

若無輸出，說明 ADB 不在 PATH 中，需添加或指定完整路徑。

2. IDEA 設置 ADB 路徑

1. File → Settings → Appearance & Behavior → System Settings → Android SDK
2. 查看 "Android SDK Location" 是否正確
3. SDK Tools 標籤勾選 "Android SDK Platform-Tools" 並 Apply

3. 手動啟動 ADB 服務

# 終端執行
adb kill-server
adb start-server
adb devices

正常應顯示設備序列號和狀態 `device`。

4. 驅動與 USB 調試

• 手機開啟「開發者選項」→「USB 調試」
• 連接電腦時選擇「傳輸文件 (MTP)」模式
• 安裝對應廠商 USB 驅動（如三星、小米、華為官網下載）
• 嘗試更換 USB 線/接口（優先 USB 2.0/3.0 直連，避免擴展塢）

5. 端口衝突處理

# 查看 5037 端口佔用
netstat -ano | findstr 5037
# 殺掉佔用進程
taskkill /PID  /F
adb start-server

6. 64 位系統兼容性（Linux）

# Ubuntu/Debian 安裝 32 位庫
sudo apt-get install libc6:i386 libstdc++6:i386 zlib1g:i386

IDEA 專項設置

• Run/Debug Configurations → General → Target Device → 勾選 "USB Device"
• Tools → Android → Enable ADB Integration（確保勾選）
• Invalidate Caches / Restart 重置索引

替代方案

• Genymotion 模擬器（自帶 ADB，性能更好）
• 真機無線調試：`adb tcpip 5555` → `adb connect <手機IP>:5555`
• Scrcpy 投屏控制工具（依賴 ADB，驗證連接）

總結檢查清單

1. SDK Platform-Tools 已安裝
2. ADB 在 PATH / IDEA 配置正確
3. 手機 USB 調試開啟、驅動安裝、授權彈窗已確認
4. adb kill/start-server 重置服務
5. 端口 5037 無衝突