做 Android 调试绕不开 adb,但真正常用的就那么几件事:无线连一下、装个包、看段日志、拉个文件、投个屏。可每次都要翻命令历史、记 IP 和端口、手敲一长串 pm list packages,效率全耗在记忆上。

AdbTools 就是把这些零散操作收进一个 Windows 桌面窗口里的工具:WPF(C#)开发,内置 adb.exe、远程控制所需的 scrcpy 设备端组件及全部依赖,装完即用——不用配 ADB 环境变量,也不用额外装 scrcpy 或 VC++ 运行库。项目以 Apache-2.0 协议开源,仓库地址:https://github.com/hcjike/AdbTools。本文按「装 → 连 → 用 → 排错」的顺序,把它最常用的部分走一遍。

一、安装:一个 exe 就够了

运行环境只有两个要求:64 位 Windows + .NET Framework 4.6.2。一般支持 Win10 1607 及以上,Win11 已内置该运行时,无需另行安装。

安装包 AdbToolsInstaller.exe 是自包含的单文件安装程序,直接双击即可,不需要先解压。几个能省心的细节:

  • 在「程序和功能」里始终只保留唯一条目,装多少个版本都不会重复出现;
  • 升级时自动读取上次安装位置并覆盖到原目录,配置和连接历史不丢;
  • 桌面与开始菜单创建名为 Adb连接工具 的快捷方式(找不到入口时按这个名字找);
  • 卸载走安装目录下的 uninstall.exe,按 install.manifest 清单精确删除,不留残渣。

装好后顶部「关于」菜单里可以直接跳到项目地址(GitHub 源码页),也可以用「检查更新」拉取新版本——安装包下到 %APPDATA%\AdbTools\cache,下载完自动启动安装程序并退出旧版本。

二、先给手机开好口子

第一步是开发者选项:进「设置 → 关于手机 → 版本号」,连续点击 7 次。之后按系统版本分两条路:

系统版本手机端操作连接地址怎么填
Android 11 及以上「设置 → 系统 → 开发者选项 → 无线调试」,连上 Wi-Fi 后开启用「无线调试」页显示的 IP:端口
Android 11 以下在开发者选项中开启 USB 调试,查看设备局域网 IP只填 IP 即可,端口默认 5555

有两条硬前提容易被忽略:电脑与手机必须在同一局域网;过低版本的设备可能根本不支持无线连接。绝大多数「连不上」都出在前者。

三、配对与连接

配对(仅 Android 11+ 需要)

点「配对 (F8)」打开配对窗口,顶部有「扫码配对 / 配对码」切换条,默认是扫码。

  • 扫码配对(推荐):窗口会生成配对二维码(协议与 Android Studio 相同),手机在「无线调试 → 使用二维码配对设备」里扫描即可。配对成功后窗口会直接关闭且不弹提示,后台自动尝试连接(最多 3 次)——这是正常现象,是否连上以设备列表为准,没出现就按一下「刷新 (F5)」。若开启了「配对结果」提醒,此时还会收到一条 Windows 通知,照着看一眼即可。
  • 输入配对码:切到「配对码」,手机在「无线调试 → 使用配对码配对设备」拿到 IP:端口 与配对码,填进窗口回车完成。部分老设备的 Wi-Fi ADB 版本较低(v1.0),扫码能力受限,这时直接走这条路。

连接

主界面输入框填 IP:端口(端口可省略,默认 5555),回车或点「连接」。连接成功的地址会自动进入下拉历史;右键某条记录可以删除单条或清空全部。

它替你敲的那些命令

下面这些是平时最常手敲的,在 AdbTools 里都变成了按钮或列表:

# 看设备(工具里就是设备列表,还带品牌型号)
adb devices -l

# 无线连接(工具里就是输入框 + 连接按钮)
adb connect 192.168.1.23:5555

# 列应用(工具里是独立的应用列表窗口,带图标和状态)
pm list packages -f

四、设备列表:所有功能都在这

设备行右键是整套功能的总入口。设备列表支持 F5 刷新与定时刷新(3 / 5 / 10 / 15 / 20 / 30 / 60 秒,设置自动保存)。

菜单项能做什么
安装应用选 APK 安装,确认窗显示应用名与包名
远程控制实时画面 + 触摸操作
文件管理浏览、上传下载、重命名删除设备文件
应用列表全部应用的名称、包名、图标、状态,可卸载 / 停用 / 清数据
Shell 窗口打开系统命令行 Shell
查看日志实时日志、Debug 日志、抓取崩溃日志、抓取诊断包
恢复默认TCP 端口 / 分辨率 / DPI / 显示
断开设备断开当前设备(二次确认)

五、四个最高频的场景

5.1 装 APK:拖一下就行

右键设备 →「安装应用」选文件;更快的做法是直接把 APK 拖到设备行上——拖进来的是文件夹会递归查找。支持 .apk 以及 .apk.1、.apk.2 这类被改过名的安装包。弹出确认窗时会先从安装包里读出应用名与包名,解析不到才回退显示文件名,避免装错包。

拖拽有个前提:程序必须是常规方式启动的。如果以管理员身份运行 AdbTools,Windows 会拦掉从资源管理器拖过来的文件,拖放不会有任何反应,这时改用右键菜单里的「安装应用」选文件即可(或关掉程序、正常启动一次)。

5.2 远程控制:投屏 + 操作

右键 →「远程控制」。画面区支持点击、拖拽与滚轮(滚轮会转成一次短距离滑动,连续滚动合并成一个手势),底部是返回 / Home / 任务 / 音量 / 电源虚拟按键。电源键有个细节:按不足 0.5 秒是短按(亮屏 / 灭屏),超过 0.5 秒放开按长按处理。顶部右侧的「1:1」按钮会把窗口调整到当前画面的像素尺寸,清晰度下拉按需切换:

档位长边建议场景
原画不缩放USB 连接、需要看清细节或截图取材
1080P 超清1920USB 或 5G Wi-Fi,兼顾清晰与流畅
720P 高清12802.4G Wi-Fi、低配电脑、设备性能较弱
480P 标清854网络差,只需点按看大致画面
360P 流畅640网络很差,只操作界面

两个「不是故障」的现象先记住:设备原生分辨率达不到的档位会被自动隐藏;编码器不兼容时会逐级向下实际验证,最后回退到 adb screenrecord(功能仍可用,流畅度下降)。状态栏的帧率统计的是真正写进画面的帧数,画面静止时显示 0 fps 是正常的。

5.3 文件管理

右键 →「文件管理」,默认打开 /sdcard。工具栏分四组:导航(返回上级 / 根目录 / SD 卡 / 临时目录 / 应用数据 / 刷新)、地址栏、文件操作(新建文件夹 / 上传文件 / 上传文件夹 / 下载)、修改(重命名 / 删除)。也能把本地文件或整个文件夹拖进列表上传,下载文件夹会保留子目录结构。

快捷键值得记:F5 刷新、Backspace 返回上级、Delete 删除(二次确认,不可恢复)、双击进入文件夹或直接下载文件、Ctrl + 按住左键划过多选。

权限上有个必须建立的概念:

  • /sdcard 可以直接读写;
  • /data/local/tmp 属 shell 用户,是系统分区里唯一能自由读写的位置;
  • /system、/vendor 只读;
  • /data/data 是应用私有目录,普通 adb shell 连列目录都不允许——这正是下一个功能的用武之地。

一句实在话:不认识的目录,先只看不写。文件管理里的删除与重命名是直接下发给设备执行的,没有回收站、没有撤销。删除前确实会二次确认并列出待删项目,但那只是让你再看一眼——点了确认就真的没了。

风险大小取决于你是在哪一层目录动手,也取决于设备有没有 root:

动手的位置删错 / 改错的后果
/sdcard 等用户存储(照片、下载、应用数据)最坏是丢文件:删了就找不回来,但系统照常开机、照常使用
/ 下的系统目录(/system、/vendor,以及 /data 关键目录)未 root 时通常直接报权限不足、操作被挡回;只有已 root 且以 root 身份操作时,误删才可能让应用异常、系统起不来甚至无法开机,往往只能刷机或恢复出厂才能修复

先别过度紧张:绝大多数设备没有 root,/system、/vendor 是只读挂载,/data 下的关键目录也受权限保护。在这些位置做删除、重命名,通常直接返回「权限不足 / Permission denied」,操作本身就被系统挡回来了——这才是最常遇到的实际情况。

真正会把东西删掉、后果又不可挽回的,基本都发生在已经 root 的设备上,并以 root 身份执行操作时。换句话说:没 root,误操作多半是「点了没反应」;有 root,误操作才可能是「真的删掉了」。

所以建议的操作习惯是:在 /sdcard 里操作,最多是心疼;在 / 下面操作,没 root 多半是被拒绝,有 root 就可能要重装。清理时只删自己上传的、或明确知道用途的文件;遇到看不懂名字的目录(尤其是 /data、/system、/vendor 下的内容),先退出去查清楚、问清楚再动手——多花五分钟确认,比花半天恢复系统划算。

5.4 应用私有数据:免 root 看 /data/data

工具栏的「应用数据」按钮是个两级视图。进去后会列出全部第三方应用,并逐个用 run-as <包名> id 探测可访问性(4 个并发,十几二十个应用大约 1 秒):可访问的排在前面并显示 uid,不可访问的灰显标「需 root」。左键双击可调试应用,就能进入它的 /data/data/<包名>,之后的浏览、新建、重命名、删除、上传、下载都以应用自身身份执行。

前提与边界要清楚:

  • 应用必须是可调试(debuggable)包,这是 run-as 通道的限制。微信、银行等正式签名包读不到,需要 root;
  • 下载走 adb exec-out run-as <包名> cat 二进制流,数据库和图片不会损坏,但整目录下载暂不支持,请选具体文件;
  • 上传是先 push 到 /data/local/tmp 再以应用身份 cp 进目标目录,落地文件属主是该应用;
  • 删除、重命名会二次确认并提示「这是应用私有数据,可能导致应用崩溃或数据丢失」——这句话不是免责声明,是真的会。

5.5 日志与崩溃诊断

「查看日志 → 实时日志」打开独立日志窗口:可切换 main / system / crash / events 缓冲区,按级别(V/D/I/W/E)与关键字过滤,支持暂停、清空、保存、自动换行,Ctrl + 单击多选后 Ctrl+C 复制。配色沿用 Android Studio logcat(V 灰、D 蓝、I 绿、W 橙、E 红、F/A 紫)。

要给别人(或给未来的自己)交材料时,用「抓取崩溃日志」导出 crash 缓冲区,或用「抓取诊断包」把 logcat、crash、dropbox、内存 / CPU 与设备信息打包成一个 zip,路径在 %APPDATA%\AdbTools\DeviceLogs\<设备名称>\。

六、让它常驻:托盘与设置

点 × 不会退出程序,而是收起到系统托盘继续后台刷新(首次会弹通知说明)。托盘图标左键单击切换主界面显示 / 隐藏,右键菜单可以直接打开某台设备的远程控制、应用列表、文件管理、Shell,也能断开指定设备或全部设备。

设置里三项值得动一下:

  • 置顶显示:调试时窗口不被其他程序盖住;
  • 定时刷新:关闭 / 3 / 5 / 10 / 15 / 20 / 30 / 60 秒,后台静默执行;
  • 消息提醒:设备连接断开、安装结果、远程控制断开、配对结果四项可分别开关。通知不会被前台抑制,主界面开着也照常提醒;如果「安装结果」被关掉或系统通知渠道不可用,程序会改用对话框展示明细兜底。

想真正退出,要么托盘右键选「退出」,要么在「设置 → 关闭方式」里改成直接退出程序(此时点 × 会先确认)。

七、数据与配置放在哪

内容路径
配置与设备连接历史%APPDATA%\AdbTools\AdbTools.config
应用名与图标缓存%APPDATA%\AdbTools\data\AdbTools.db
抓取的日志与诊断包%APPDATA%\AdbTools\DeviceLogs\<设备名称>\
程序 / 远程控制 / 应用列表日志%APPDATA%\AdbTools\logs\(按天分文件,保留 7 天)
临时文件%APPDATA%\AdbTools\cache(每次启动自动清空)

缓存按设备隔离(设备键依次取 ro.serialno → ro.boot.serialno → android_id),所以同一台手机换种连接方式也不会重复解析一遍图标。

八、常见问题速查

现象原因与处理
连接失败多数是没在同一局域网,或无线调试未开、IP/端口填错
配对窗口自己关了配对成功的正常表现,后台自动连接,看设备列表为准
程序起不来缺 .NET Framework 4.6.2,补上运行时再启动
找不到程序入口开始菜单里的 Adb连接工具 快捷方式
拖 APK 到设备行没反应程序以管理员身份启动时会被系统拦截拖放,改为常规启动,或用右键「安装应用」选文件
/data/data 打不开属系统保护目录,改用「应用数据」入口走 run-as,且目标须为 debug 包
不确定某个目录能不能删先只看不写:/sdcard 里删错最多丢文件;/ 下(/system、/vendor、/data 关键目录)没 root 时多半报权限不足被挡回,有 root 时误删可能导致系统无法开机
删系统目录没反应 / 报错属正常现象:无 root 时这些目录只读且受权限保护,操作会被系统拒绝
画面几秒才变一次静止界面本就不产帧;播放视频仍黑屏多为 DRM 安全图层,改用 HDMI 采集卡
TV 盒子投屏卡手动降到 720P / 480P;日志提示回退 screenrecord 说明该 ROM 限制了 app_process
提示「系统缺少媒体组件」Windows N / KN 版或精简系统,装媒体功能包
点了 × 没退出默认收到托盘,托盘右键「退出」,或改「关闭方式」
操作有粘滞感设备端采集编码 + adb 往返约 100~200 ms,降清晰度档位可缓解

九、上手清单

  1. 确认系统为 64 位 Windows 且已装 .NET Framework 4.6.2,双击安装包完成安装。
  2. 手机连点版本号 7 次开启开发者选项;Android 11+ 打开「无线调试」。
  3. Android 11+ 先「配对 (F8)」,扫码或输配对码;成功后以设备列表为准。
  4. 输入 IP:端口 连接,连上的地址会进历史下拉框。
  5. 用常规方式启动程序,拖一个 APK 到设备行上,验证安装与「应用名 + 包名」确认窗。
  6. 开一次远程控制,按网络情况选清晰度;USB 下可试原画。
  7. 进「文件管理」上一次 /data/local/tmp 收发文件,再用「应用数据」看一个 debug 包的私有目录。
  8. 在一台真机上复现一次问题,用「抓取诊断包」导出 zip,确认日志路径可用。

AdbTools 采用 Apache License 2.0 开源(Copyright 2025 宏尘),源码仓库:https://github.com/hcjike/AdbTools。内置的 scrcpy 5.0.1 设备端组件与各第三方库的版本、来源、SHA-256 都记录在安装包的 THIRD_PARTY_NOTICES.txt 里,用之前值得扫一眼。

装好之后建议按上面的清单走一遍:配对 → 连接 → 装包 → 投屏,四步跑通,后面绝大多数调试就不必再回到命令行。