一、为什么需要多设备日志管理？
做 Android 开发久了，你一定会遇到这种情况：桌上摆着三五台测试机，有 Pixel、有小米、有 OPPO，每台都在跑不同的测试场景。这时候如果还一台一台地开终端抓日志，效率实在太低了。
我个人习惯是，能一次搞定的事绝不重复做。多设备日志管理，说白了就是让你用一条命令，同时看到所有设备的日志输出。这在调试多设备交互、对比不同机型行为时特别有用。
核心场景：
- 同时测试多台设备的同一功能
- 对比不同 Android 版本的日志差异
- 监控多设备间的通信（如蓝牙、Wi-Fi Direct）
- 自动化测试中批量收集日志
二、基础：先搞清楚设备标识
在开始多设备管理之前，你得先知道怎么区分设备。每台 Android 设备都有一个唯一的序列号，adb 就是靠这个来识别不同设备的。
2.1 查看已连接的设备
adb devices输出示例：
List of devices attached
emulator-5554 device
0123456789ABCDEF device
192.168.1.100:5555 device这里有三台设备：一台模拟器、一台 USB 连接的实体机、一台通过网络连接的设备。嗯，这里要注意，如果设备状态显示 "unauthorized"，说明还没授权，需要先在手机上确认。
2.2 设备序列号的获取方式
| 连接方式 | 序列号格式 | 示例 |
|---|---|---|
| USB 连接 | 厂商分配的序列号 | 0123456789ABCDEF |
| 模拟器 | emulator-端口号 | emulator-5554 |
| 网络连接 | IP:端口 | 192.168.1.100:5555 |
我在项目中遇到过，有些国产手机的序列号特别长，或者包含特殊字符。这时候建议用 adb -s 指定设备时，直接把序列号复制出来，别手打，容易出错。
三、核心操作：同时抓取多设备日志
3.1 方法一：分别启动多个终端
最直接的办法，就是开多个终端窗口，每个窗口连一台设备：
# 终端1：抓取模拟器日志
adb -s emulator-5554 logcat
# 终端2：抓取实体机日志
adb -s 0123456789ABCDEF logcat这个方法简单粗暴，但缺点也很明显——窗口多了容易乱，而且没法统一管理。
3.2 方法二：使用 adb 的 -e 和 -d 参数
如果你只有一台模拟器和一台实体机，可以用更简洁的方式：
# 只抓模拟器
adb -e logcat
# 只抓实体机
adb -d logcat但说实话，这个方式局限性很大。一旦连接了多台实体机，-d 就不知道选哪台了。
3.3 方法三：脚本批量处理（推荐）
我个人最推荐的方式，是写一个简单的 shell 脚本，同时启动多个 logcat 进程，并把日志分别保存到不同文件：
#!/bin/bash
# 获取所有设备序列号
devices=$(adb devices | grep -w "device" | awk '{print $1}')
for device in $devices; do
echo "开始抓取设备: $device"
adb -s $device logcat -v threadtime > "log_${device}_$(date +%Y%m%d_%H%M%S).log" &
done
echo "所有设备日志抓取中，按 Ctrl+C 停止"
wait小技巧： 脚本里的 & 符号让每个 logcat 在后台运行，这样就能同时抓取多台设备。日志文件名带上设备序列号和时间戳，方便后续查找。
四、进阶：统一时间戳与日志过滤
多设备日志最头疼的问题是什么？时间不同步。你想想看，两台设备的时间可能差了好几秒，对比日志时根本对不上。
4.1 统一时间基准
我建议在抓取日志前，先同步所有设备的时间：
# 同步所有设备时间为当前系统时间
for device in $(adb devices | grep -w "device" | awk '{print $1}'); do
adb -s $device shell date $(date +%m%d%H%M%Y.%S)
done这样做之后，所有设备的日志时间戳就基本一致了。当然，网络延迟会有毫秒级误差，但对于大多数调试场景已经够用。
4.2 统一过滤规则
如果只关心某个标签的日志，可以给所有设备设置相同的过滤条件：
#!/bin/bash
TAG="MyApp"
devices=$(adb devices | grep -w "device" | awk '{print $1}')
for device in $devices; do
echo "设备 $device 只抓取标签: $TAG"
adb -s $device logcat -s $TAG -v threadtime > "log_${device}_${TAG}.log" &
done
wait注意： 如果设备数量超过 5 台，建议不要把所有日志都输出到终端，否则刷屏速度会让你眼花缭乱。最好直接保存到文件，需要时再用 grep 分析。
五、实战：多设备日志对比分析
有一次我在调试一个蓝牙配对问题，两台手机需要互相发现并建立连接。单看一台设备的日志根本看不出问题在哪。后来我同时抓了两台设备的日志，才发现是其中一台的蓝牙广播间隔设置得太长，导致另一台收不到信号。
具体做法是这样的：
- 用脚本同时启动两台设备的 logcat，保存到不同文件
- 在手机上执行配对操作
- 停止抓取后，用 diff 工具对比两个日志文件
# 对比两台设备的日志
diff -u log_deviceA.log log_deviceB.log | less通过对比，能清晰看到事件发生的先后顺序，以及哪台设备在哪个环节出了问题。
六、多设备日志管理的知识体系
下面这张图总结了本章的核心内容，你可以把它当作一个快速参考：
七、避坑指南
最后分享几个我踩过的坑：
- 设备断开后日志中断： 我曾经在抓日志时不小心碰掉了 USB 线，结果脚本直接退出了。后来我加了自动重连逻辑，检测到设备断开就等待 5 秒后重试。
- 日志文件过大： 多台设备同时抓日志，文件增长很快。建议加上
-G参数限制缓冲区大小，或者定期轮转日志文件。 - 权限问题： 有些设备需要 root 才能读取某些系统日志。如果发现某台设备日志特别少，先检查一下权限。
我的习惯： 每次开始多设备抓取前，先跑一遍 adb devices -l 确认所有设备都在线，并且能看到设备型号。这样万一哪台没抓到，能快速定位是连接问题还是脚本问题。
多设备日志管理，说白了就是让你从「一台一台地查」变成「一眼看全局」。掌握了这些方法，以后再遇到多设备联调的场景，你就能从容应对了。
公众号:蓝海资料掘金营，微信deep3321