工具用的順手嗎?
你的回饋能幫助我們做得更好
提供Android除錯橋常用命令速查,涵蓋裝置連線、應用管理等指令。
所收錄的ADB和Android Shell命令參考,不連線或操作裝置。需按端末/Platform-Tools版本確認幫助和許可權;backup/restore是舊命令,不保證當前可用。資料刪除、系統設定和分割槽操作會改變裝置狀態。 參考來源
列出当前已连接的全部 Android 设备及其状态。
adb devices [-l]adb devices -l通过 TCP/IP 方式连接到指定设备(需先开启网络调试)。
adb connect <host>[:port]adb connect 192.168.1.20:5555断开指定的 TCP/IP 设备连接,省略地址则断开全部。
adb disconnect [host[:port]]adb disconnect 192.168.1.20:5555Android 11+ 无线调试配对,用于首次建立可信连接。
adb pair <host>:<port>adb pair 192.168.1.20:37123将设备的 adb 切换为 TCP/IP 监听模式,便于后续无线连接。
adb tcpip <port>adb tcpip 5555将 adb 切换回 USB 监听模式,关闭网络调试。
adb usbadb usb强制结束本地 adb server 进程,常用于连接异常时重置。
adb kill-serveradb kill-server启动本地 adb server 进程,多数命令会自动触发。
adb start-serveradb start-server在多设备场景下通过序列号指定目标设备执行命令。
adb -s <serial> <command>adb -s emulator-5554 shell pm list packages阻塞当前命令,直到至少有一台设备连接到 adb。
adb wait-for-device [next-command]adb wait-for-device shell getprop ro.product.model查看本机 adb 客户端的版本号与协议版本。
adb versionadb version获取设备当前状态,如 device、bootloader、offline。
adb get-stateadb get-state查询当前设备的序列号。
adb get-serialnoadb get-serialno读取 Android 系统属性,可获取型号、版本、SDK 等信息。
adb shell getprop [name]adb shell getprop ro.build.version.release查看电池电量、温度、是否充电等详细状态。
adb shell dumpsys batteryadb shell dumpsys battery查看进程内存占用,可定位内存泄漏。
adb shell dumpsys meminfo [package|pid]adb shell dumpsys meminfo com.android.chrome查看或修改设备屏幕分辨率。
adb shell wm size [WxH|reset]adb shell wm size 1080x1920查看或修改屏幕像素密度(dpi)。
adb shell wm density [dpi|reset]adb shell wm density 320向设备安装 APK,支持升级、降级、保留数据等选项。
adb install [-r|-t|-d|-g] <apk>adb install -r app-release.apk一次安装多个 APK,常用于 Split APK / AAB。
adb install-multiple [选项] <apk...>adb install-multiple base.apk config.armeabi_v7a.apk卸载指定包名的应用。
adb uninstall [-k] <package>adb uninstall com.example.app列出设备上的所有应用包名。
adb shell pm list packages [-3|-s|-f]adb shell pm list packages -3获取指定包名应用的 APK 安装路径。
adb shell pm path <package>adb shell pm path com.android.chrome清除应用的全部数据与缓存,相当于卸载重装。
adb shell pm clear <package>adb shell pm clear com.example.app为当前用户禁用指定应用,常用于停用系统应用。
adb shell pm disable-user [--user <id>] <package>adb shell pm disable-user --user 0 com.example.bloat通过 Activity Manager 启动一个 Activity。
adb shell am start [-n component|-a action]adb shell am start -n com.android.settings/.Settings强制停止指定包名的应用进程。
adb shell am force-stop <package>adb shell am force-stop com.example.app发送一个广播 Intent,常用于触发组件逻辑或测试。
adb shell am broadcast -a <action> [extras]adb shell am broadcast -a android.intent.action.BOOT_COMPLETED向应用发送伪随机事件,做压力或稳定性测试。
adb shell monkey [选项] -p <package> <count>adb shell monkey -p com.example.app -v 500把本地文件或目录上传到设备指定路径。
adb push <local> <remote>adb push ./config.json /sdcard/Download/把设备上的文件或目录拉取到本地。
adb pull <remote> [local]adb pull /sdcard/DCIM/Camera ./photos增量同步本机构建产物到设备相应目录(system/vendor/data)。
adb sync [分区]adb sync system列出设备目录下的文件与子目录。
adb shell ls [-l|-a] <path>adb shell ls -l /sdcard/删除设备上的文件或目录,请谨慎使用。
adb shell rm [-r|-f] <path>adb shell rm -rf /sdcard/Download/tmp复制设备内部的文件或目录。
adb shell cp [-r] <src> <dst>adb shell cp /sdcard/a.txt /sdcard/b.txt移动或重命名设备上的文件、目录。
adb shell mv <src> <dst>adb shell mv /sdcard/a.log /sdcard/old/a.log在设备上创建目录,可递归创建多层。
adb shell mkdir [-p] <dir>adb shell mkdir -p /sdcard/MyApp/cache查看设备的系统及应用日志,是排查问题的核心工具。
adb logcat [选项] [filterspec]adb logcat '*:E'清空设备上的所有 logcat 日志缓冲区。
adb logcat -cadb logcat -c导出当前已缓存的日志后立即退出。
adb logcat -dadb logcat -d > device.log指定日志输出格式,如 time、threadtime、long。
adb logcat -v <format>adb logcat -v threadtime生成完整的 bug report 压缩包,包含日志、dumpsys、堆栈等。
adb bugreport [path]adb bugreport ./bugreport.zip查看内核环形缓冲区的日志信息。
adb shell dmesgadb shell dmesg | tail -n 100进入设备的交互式 shell,或一次性执行指定命令。
adb shell [command]adb shell向当前输入框模拟键入文本。
adb shell input text <text>adb shell input text hello模拟按键事件,如返回、Home、音量等。
adb shell input keyevent <code>adb shell input keyevent 4在屏幕指定坐标模拟一次点击。
adb shell input tap <x> <y>adb shell input tap 500 1200模拟滑动手势,可控制时长实现长按。
adb shell input swipe <x1> <y1> <x2> <y2> [ms]adb shell input swipe 300 1000 300 200 200读取或写入系统设置(global/system/secure)。
adb shell settings [get|put] <ns> <key> [value]adb shell settings put global airplane_mode_on 1截取设备屏幕并保存为 PNG 图片。
adb shell screencap -p <path>adb shell screencap -p /sdcard/screen.png录制屏幕视频(Android 4.4+),保存为 MP4。
adb shell screenrecord [选项] <path>adb shell screenrecord --time-limit 30 /sdcard/demo.mp4无中转文件直接将截图传到本地。
adb exec-out screencap -p > <local.png>adb exec-out screencap -p > screen.png重启设备,可指定进入特殊模式。
adb reboot [bootloader|recovery|sideload]adb reboot recovery在支持的 ROM 上让 adbd 以 root 身份运行。
adb rootadb root退出 root 模式,让 adbd 回到普通用户权限。
adb unrootadb unroot将系统分区重新挂载为可读写,常配合修改系统文件。
adb remountadb remount关闭系统分区的校验,使 remount 写入生效。
adb disable-verityadb disable-verity重新开启系统分区的 dm-verity 校验。
adb enable-verityadb enable-verity通过 recovery 模式向设备刷入 OTA 或完整 zip 包。
adb sideload <package.zip>adb sideload update.zip备份设备数据为 .ab 文件(Android 6 后系统逐步弱化)。
adb backup [选项] [-f file]adb backup -all -f backup.ab将之前 adb backup 生成的 .ab 文件恢复回设备。
adb restore <file>adb restore backup.ab将本机端口转发到设备端口,常用于调试本地与设备通讯。
adb forward <local> <remote>adb forward tcp:8080 tcp:8080列出当前 adb forward 已建立的全部端口映射。
adb forward --listadb forward --list移除指定的本机端口转发规则。
adb forward --remove <local>adb forward --remove tcp:8080将设备端口反向转发到本机端口,让 App 访问本地服务。
adb reverse <remote> <local>adb reverse tcp:3000 tcp:3000查看当前设备反向端口转发列表。
adb reverse --listadb reverse --list移除指定的设备到本机的反向端口转发。
adb reverse --remove <remote>adb reverse --remove tcp:3000查看设备各网络接口的 IP、MAC、状态。
adb shell ip addradb shell ip addr show wlan0在设备端发起 ICMP 测试,判断网络连通性。
adb shell ping <host>adb shell ping -c 4 8.8.8.8列出可被 JDWP 调试器附加的 Java 进程 PID。
adb jdwpadb jdwp实时查看设备进程的 CPU、内存占用。
adb shell top [-n <times>]adb shell top -n 1快照当前设备运行中的进程列表。
adb shell ps [-A|-T]adb shell ps -A | grep com.example导出指定系统服务或全部服务的运行状态。
adb shell dumpsys [service]adb shell dumpsys activity activities设置系统属性,调试日志、调度等行为。
adb shell setprop <name> <value>adb shell setprop log.tag.MyTag VERBOSE对指定进程开启或停止 method tracing 性能采样。
adb shell am profile start|stop <process> [file]adb shell am profile start com.example /sdcard/trace.traceAndroid 7+ 提供的 activity 调试命令集,可控制睡眠、模式等。
adb shell cmd activity <subcmd>adb shell cmd activity start -n com.example/.MainActivity概覽
了解工具能解決的問題、計算或處理邏輯,以及資料邊界。
Android Debug Bridge(ADB)讓電腦透過命令列與 Android 手機、平板或模擬器通訊。這份參考表依連線、裝置資訊、應用程式、檔案、日誌、Shell、截圖錄影、系統、網路與除錯效能分類;卡片提供命令名稱、用途、語法、範例及部分補充說明。它是查找靜態文字的索引,不會連接你的裝置,也不會替你執行指令。
語法中的尖括號通常表示要換成自己的值,例如 <serial> 是裝置序號、<package> 是套件名稱;方括號常標示可省略的參數。參考範例裡的路徑、套件、主機位址及連接埠只是示意,執行前須按實際環境修改。ADB 官方文件說明,命令從電腦端送出並由連線裝置處理;安裝、檔案傳輸、shell 等操作是否可用,仍受裝置狀態、Android 版本與權限影響。官方文件核對日期:2026-09-30。
繁體中文介面可用關鍵字與分類查找;部分命令卡片的說明或示例可能仍以原始簡體中文呈現,命令本身則保留終端使用的英文拼法。內容不代表某一 Android/Platform Tools 版本的完整命令清單。
指南
依步驟完成操作,並透過範例核對輸入與結果。
先按任務想好搜尋詞,例如 devices 查連線、install 查安裝、logcat 查記錄,或輸入用途詞,再視需要選擇命令分類。
比對卡片的用途、語法、範例與備註。搜尋會檢查命令名稱、說明、語法、範例及備註;切換分類可縮小清單。若沒有結果,改用命令英文片段或切回「全部」。
將佔位文字改成自己的值,並確認電腦終端所在位置、檔案路徑和目標裝置。若連接多台裝置,先查看 adb devices -l 的序號,再依官方語法以 adb -s <serial> <command> 指定對象。
執行前在已安裝 Platform Tools 的終端逐字檢查命令。複製卡片只會複製命令名稱、語法或範例文字,不會代為執行;遇到版本差異可在本機查 adb --help,或查看 Android Developers 文件。
adb devices。狀態若不是可用的 device,先排查連線或授權;不要把序號出現誤當成每一條指令都有足夠權限。adb install,核對 APK 路徑和裝置目標。覆蓋安裝範例若使用 -r,請先確認這符合測試目的與裝置上的應用狀態。adb logcat,再依卡片語法考慮輸出格式或篩選條件。日誌內容可能含個人或帳號資訊,整理後再交付。adb push、adb pull 或截圖相關卡片確認本機與裝置路徑的方向,再核對目的路徑是否可寫。情境
查看這項工具在不同工作與生活流程中的用法。
手邊同時連著實機與模擬器時,先搜尋裝置清單指令辨認序號,再找帶有目標選擇參數的語法。複製前比對序號和後續操作,避免安裝到錯誤裝置。
遇到應用程式異常時,可查找 logcat、螢幕截圖或螢幕錄製命令,將卡片範例改成符合目前測試步驟的版本。輸出的記錄只作除錯線索,分享前要檢查敏感資料。
需要複製測試檔或檢查套件狀態時,先用分類找到 push、pull 或應用管理相關卡片,再確認路徑、套件名稱和權限。此頁只幫助查語法,實際結果須在自己的電腦和裝置上確認。
問答
集中解答常見疑問與容易混淆的問題。
不行。頁面只提供可搜尋、可複製的命令參考卡;你仍須在已安裝 ADB 的電腦終端執行,並自行連接及選定裝置。
搜尋會比對卡片中的命令名、說明、語法、範例與備註,因此可以試英文命令名或卡片實際使用的詞。分類按鈕也可直接縮小結果。介面採繁體中文,但部分資料卡文字可能保留簡體原文。
命令選項可能因 ADB/Platform Tools 或 Android 版本、ROM、裝置狀態和授權而不同。先看終端回覆與本機 adb --help,再對照 Android 官方文件及裝置廠商說明;參考卡不會辨識你的實際環境。
先用 adb devices -l 核對清單與序號,再依官方 ADB 語法在命令前加上 -s <serial>。每次執行會改動狀態的命令前都重新確認目標。
須知
使用前了解適用範圍、結果限制與必要提醒。
命令卡不會檢查你的裝置,也無法保證指令對目前版本適用。清除應用程式資料、刪除檔案、停用套件、重開機、修改系統設定或寫入系統分區,都可能造成資料遺失、服務中斷或無法預期的狀態改變。特別檢查遞迴、強制、裝置序號、套件名稱和路徑;不確定時先不要執行。
只對自己有權管理的裝置使用 USB 或無線偵錯,並在可信任的電腦上接受裝置授權。分享 logcat、bug report、截圖或診斷檔前,檢查並移除帳號、識別資訊、權杖及其他不宜公開內容。若命令可能影響重要資料,先確認有可用備份及復原方式。
命令清單不是官方版本保證,條目與語法可能隨工具及系統演進。以目前安裝版本的命令說明、Android Developers 官方文件和裝置實際回應為準。
推薦
查找相關工具、專題與可用的 API 能力。