做 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 超清 | 1920 | USB 或 5G Wi-Fi,兼顾清晰与流畅 |
| 720P 高清 | 1280 | 2.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,降清晰度档位可缓解 |
九、上手清单
- 确认系统为 64 位 Windows 且已装 .NET Framework 4.6.2,双击安装包完成安装。
- 手机连点版本号 7 次开启开发者选项;Android 11+ 打开「无线调试」。
- Android 11+ 先「配对 (
F8)」,扫码或输配对码;成功后以设备列表为准。 - 输入
IP:端口连接,连上的地址会进历史下拉框。 - 用常规方式启动程序,拖一个 APK 到设备行上,验证安装与「应用名 + 包名」确认窗。
- 开一次远程控制,按网络情况选清晰度;USB 下可试原画。
- 进「文件管理」上一次
/data/local/tmp收发文件,再用「应用数据」看一个 debug 包的私有目录。 - 在一台真机上复现一次问题,用「抓取诊断包」导出 zip,确认日志路径可用。
AdbTools 采用 Apache License 2.0 开源(Copyright 2025 宏尘),源码仓库:https://github.com/hcjike/AdbTools。内置的 scrcpy 5.0.1 设备端组件与各第三方库的版本、来源、SHA-256 都记录在安装包的 THIRD_PARTY_NOTICES.txt 里,用之前值得扫一眼。
装好之后建议按上面的清单走一遍:配对 → 连接 → 装包 → 投屏,四步跑通,后面绝大多数调试就不必再回到命令行。
AdbTools 使用指南:在 Windows 上把 ADB 无线调试做成可视化操作
https://www.hcjike.com/archives/Vq8Lm2Zt